Created
June 27, 2025 12:17
-
-
Save Refzlund/c353cd7457c21106c7c10ae9226d8276 to your computer and use it in GitHub Desktop.
Podman Windows Set-up for Docker compatability
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# 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