From aaa9696ac191dd687e9a05b5a1ddcba78cfc87a0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fabrice=20Flore-Th=C3=A9bault?= <ffloreth@redhat.com>
Date: Fri, 23 Dec 2022 17:20:52 +0100
Subject: [PATCH] docs: Using the `podman-mac-helper` tool to migrate from
 Docker (#1088)

---
 ...-migrate-from-docker-to-podman-on-macos.md | 70 +++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 website/docs/getting-started/using-podman-mac-helper-to-migrate-from-docker-to-podman-on-macos.md

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 <your_container> > <your_container_archive>.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 <your_container_archive>.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 <your_container> 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)
+