Skip to content

Instantly share code, notes, and snippets.

@Refzlund
Created June 27, 2025 12:17
Show Gist options
  • Save Refzlund/c353cd7457c21106c7c10ae9226d8276 to your computer and use it in GitHub Desktop.
Save Refzlund/c353cd7457c21106c7c10ae9226d8276 to your computer and use it in GitHub Desktop.
Podman Windows Set-up for Docker compatability
# winget install --id RedHat.Podman-Desktop -e
# Windows
0. Ensure Git is installed
1. Install DockerCLI + DockerCompose
`winget install --id Docker.DockerCLI -e`
`winget install --id Docker.DockerCompose -e`
2. Prerequisities in terminal (as administrator)
2.a Docker CLI `winget install --id Docker.DockerCLI -e`
2.b Docker Compose `winget install --id Docker.DockerCompose -e`
2.c Podman `winget install -e --id RedHat.Podman`
2.d Podman Desktop `winget install --id RedHat.Podman-Desktop -e`
2.e Enable Virtual Machine Platform `dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart`
2.f Update WSL `wsl --update`
2.g Restart PC
3. Ensure a podman machine is installed and is rootful (in adminsitrator terminal)
Run `podman system connection ls` (should show root@podman-machine-default)
If none, create one: `podman machine init --rootful --now`
If one, ensure it's rootful:
`podman machine disable`
`podman machine set --rootful`
`podman machine enable`
4. Enable Docker (+ Compose) compatability
In Podman Desktop
- Settings ▸ (Preferences dropdown) ▸ Docker Compatibility ▸ Enable
5. Set/ensure VSCode Setting requirements
```jsonc
{
"dev.containers.executeInWSL": false
}
```
----
Troubleshoot
- Error regarding docker path having bad format
The Docker Compatability option in Podman forwards Docker to Podman.
So delete DOCKER_HOST environment variable if it's there.
> For the WSL environment: `wsl -- bash -c 'unset DOCKER_HOST'`
> For Windows (host): CTRL+R `SystemPropertiesAdvanced` ▸ Environment Variables ▸ Delete where "Variable" is "DOCKER_HOST" (if exists)
- Git clone failed. remote: Support for password authentication was removed on August 13, 2021.
Ensure Git is installed on the host (Windows) machine,
and make sure Git is authenticated using a Github account that has access to the repository you're trying to clone.
When cloning, it should prompt a box for logging in with Git (to Github, or via login etc.)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment