Managing Docker compatibility
With Podman Desktop, you can configure a Docker-compatible environment using the Settings page. After configuration, your Docker tools are directed to use a Podman engine and your Compose applications can be run using the Podman CLI.
As a developer, you can:
-
Check the system socket mapping status to know whether the socket is reachable. The default socket path is:
- /var/run/docker.sock on macOS
- npipe:////./pipe/docker_engine on Windows
-
Use all Docker tools, including CLI, with the Podman engine without any reconfiguration. These tools connect to the default Podman socket, thereby enabling you to use all Docker commands with Podman. For example, you can run the
docker run
command on the Podman engine to start a container.- By default, third-party Docker tool compatibility is enabled on macOS.
-
Use the Podman CLI to run Compose applications by installing and setting up the Compose extension. For example, you can run the
docker compose up
command on the Podman engine to start your Compose v2 application. Also, ensure to place your Docker Compose file in a working directory, such as your home directory.- If the Compose CLI is not installed, you get the install option in the settings.
-
Select and use a Docker-compatible socket context. You can also view the socket details, such as name and socket path.
Prerequisites
- Windows
- macOS
Procedure
- Go to Settings > Docker Compatibility.
- Socket Mapping Status setting: View the socket mapping status to check whether the socket is reachable.
- Podman Compose CLI Support setting: Check whether the Podman Compose CLI is supported. If not, use the Install icon to install and set up the Podman CLI.
- Docker CLI Context setting: Select a socket context to work with from the dropdown list.
Procedure
- Go to Settings > Docker Compatibility.
- Socket Mapping Status setting: View the socket mapping status to check whether the socket is reachable.
- Third-Party Docker Tool Compatibility setting: Customize the setting, if needed. When enabled, you can use third-party Docker tools with Podman.
- Podman Compose CLI Support setting: Check whether the Podman Compose CLI is supported. If not, use the Install icon to install and set up the Podman CLI.
- Docker CLI Context setting: Select a socket context to work with from the dropdown list.
Verification
- Run
podman
orpodman compose
commands for your Compose applications to check if they run fine.