Skip to content

Commit

Permalink
docs: updated 'podman-mac-helper' documentation verification examples -
Browse files Browse the repository at this point in the history
fixes # 3640

Signed-off-by: Fabrice Flore-Thébault <[email protected]>
  • Loading branch information
themr0c committed Aug 28, 2023
1 parent 1193d39 commit 51ab06f
Showing 1 changed file with 14 additions and 15 deletions.
29 changes: 14 additions & 15 deletions website/docs/migrating-from-docker/using-podman-mac-helper.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,32 +25,31 @@ The service redirects `/var/run/docker` to the fixed user-assigned UNIX socket l

#### Procedure

- Set up the `podman-mac-helper` service for each user.
Run the command:
1. To set up the `podman-mac-helper` service: run the command in a terminal:

```sh
sudo podman-mac-helper install
```

For additional install options please run the command:
```shell-session
sudo podman-mac-helper install
```

```sh
sudo podman-mac-helper install --help
```
1. To restart your Podman machine: go to **<icon icon="fa-solid fa-cog" size="lg" /> Settings > Resources**, and in the Podman tile, click <icon icon="fa-solid fa-repeat" size="lg" />.

#### Verification

1. Your tools communicating to the Docker socket, such as [Maven](https://maven.apache.org/) or [Testcontainers](https://www.testcontainers.org/), communicate with Podman without reconfiguration.
1. The Docker socket is a symbolic link for the Podman socket:

2. 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`.
```shell-session
$ ls -la /var/run/docker.sock
```

Example:
2. The `docker` CLI communicates with the Podman socket.
Therefore this command outputs Podman version rather that Docker version:

```shell-session
$ podman-mac-helper run -it <your_container> bash
$ DOCKER_HOST=unix:///var/run/docker.sock docker info --format=json | jq -r .ServerVersion
```

3. Your tools communicating to the Docker socket, such as [Maven](https://maven.apache.org/) or [Testcontainers](https://www.testcontainers.org/), communicate with Podman without reconfiguration.

#### Additional resources

- [`podman-mac-helper` source](https://github.com/containers/podman/tree/main/cmd/podman-mac-helper)
Expand Down

0 comments on commit 51ab06f

Please sign in to comment.