diff --git a/website/docs/getting-started/using-podman-mac-helper-to-migrate-from-docker-to-podman-on-macos.md b/website/docs/getting-started/using-podman-mac-helper-to-migrate-from-docker-to-podman-on-macos.md new file mode 100644 index 00000000000..433ce987680 --- /dev/null +++ b/website/docs/getting-started/using-podman-mac-helper-to-migrate-from-docker-to-podman-on-macos.md @@ -0,0 +1,70 @@ +--- +id: using-podman-mac-helper-to-migrate-from-docker-to-podman-on-macos.md +title: Using the `podman-mac-helper` tool on macOS +description: Using the `podman-mac-helper` tool can make it easier to migrate from Docker to Podman on macOS, as it allows you to continue using familiar Docker commands while taking advantage of the benefits of Podman. +tags: [podman-desktop, getting-started, podman-mac-helper, macOS] +keywords: [podman desktop, podman, containers] +--- + +# Using the `podman-mac-helper` tool to migrate from Docker to Podman on macOS + +Consider using `podman-mac-help` to migrate transparently to Podman on macOS. + +* Continue using familiar Docker commands. +* Take advantage of the benefits of Podman on macOS. +* Your tools, such as Maven or test containers, communicate with Podman without reconfiguration. + +The `podman-mac-helper` tool provides a compatibility layer that allows you to use most Docker commands with Podman on macOS. +The service redirects `/var/run/docker` to the fixed user-assigned UNIX socket location. + +#### Prerequisites + +* macOS +* [Podman](../Installation/macos-install) +* [Homebrew](https://brew.sh/) +* (Optional) You saved your existing Docker containers by running the command: + + ``` + $ docker save > .tar + ``` + +* Docker service is [paused](https://docs.docker.com/desktop/use-desktop/pause/) and [*Start Docker Desktop when you log in* is disabled](https://docs.docker.com/desktop/settings/mac/), or Docker is [uninstalled](https://docs.docker.com/desktop/uninstall/). + +#### Procedure + +1. Install the `podman-mac-helper` tool. + Run the command: + + ``` + $ brew install podman-mac-helper + ``` + +2. Set up the `podman-mac-helper` service for each user. + Run the command: + + ``` + $ podman-mac-helper setup + ``` + +3. (Optional) Import your existing containers into Podman. + Run the command for each container archive: + + ``` + $ podman import .tar + ``` + +4. Use the `podman-mac-helper` tool to run commands. + To run a command with Podman by using the `podman-mac-helper` tool, prefix the command with `podman-mac-helper`. + + Example: + + ``` + $ podman-mac-helper run -it bash + ``` + +#### Additional resources + +* [`podman-mac-helper` source](https://github.com/containers/podman/tree/main/cmd/podman-mac-helper) +* [`docker save` reference documentation](https://docs.docker.com/engine/reference/commandline/save/) +* [`podman import` reference documentation](https://docs.podman.io/en/latest/markdown/podman-import.1.html) +