Elgato_dark/podman-desktop
1
0
Fork 0
mirror of https://github.com/podman-desktop/podman-desktop synced 2026-05-24 10:18:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: Using the podman-mac-helper tool to migrate from Docker (#1088)

Browse source
This commit is contained in:
Fabrice Flore-Thébault 2022-12-23 17:20:52 +01:00 committed by GitHub
parent 01da111013
commit aaa9696ac1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 70 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

70
website/docs/getting-started/using-podman-mac-helper-to-migrate-from-docker-to-podman-on-macos.md Normal file
View file

@ -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)