docs: Verifying that your tools are using Podman

fixes: #1036 Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>
containers · Jan 10, 2023 · 667557f · 667557f
1 parent e14fb9b
commit 667557f
Show file tree

Hide file tree

Showing 2 changed files with 35 additions and 1 deletion.
diff --git a/website/docs/migrating-from-docker/index.md b/website/docs/migrating-from-docker/index.md
@@ -10,7 +10,8 @@ tags: [migrating-from-docker]
 
 When you have used Docker in the past, you can continue using familiar workflows with Podman Desktop:
 
-* [Importing saved containers to Podman to continue using familiar containers](migrating-from-docker/importing-saved-containers.md)
+* [Importing saved containers to Podman to continue using familiar containers](migrating-from-docker/importing-saved-containers)
 * [Using the `DOCKER_HOST` environment variable to let your tools communicate directly with the Podman socket](migrating-from-docker/using-the-docker_host-environment-variable)
 * [Using the `podman-mac-helper` tool on macOS to redirect the Docker socket to the Podman socket](migrating-from-docker/using-podman-mac-helper)
 * [Emulating Docker CLI with Podman to continue using tools depending on the Docker CLI](migrating-from-docker/emulating-docker-cli-with-podman)
+* [Verifying that your tools are using Podman](migrating-from-docker/verifying-your-tools-are-using-podman)
diff --git a/website/docs/migrating-from-docker/verifying-your-tools-are-using-podman.md b/website/docs/migrating-from-docker/verifying-your-tools-are-using-podman.md
@@ -0,0 +1,33 @@
+---
+sidebar_position: 5
+title: Verifying your tools are using Podman
+description: Verify that your tools are using Podman rather than Docker.
+keywords: [podman desktop, podman, containers, migrating, docker]
+tags: [migrating-from-docker]
+---
+
+# Verifying that your tools are using Podman
+
+When you have configured your host to use Podman rather then Docker, consider verifying your setup works as intended.
+
+#### Prerequisites
+
+* Docker service is not installed, or stopped.
+* [Saved containers are imported to Podman](importing-saved-containers)
+* [The `DOCKER_HOST` environment variable is set](using-the-docker_host-environment-variable)
+* [On macOS, the `podman-mac-helper` service is running](using-podman-mac-helper)
+* [Podman is emulating Docker CLI](emulating-docker-cli-with-podman)
+
+#### Procedure
+
+1. The Docker socket replies successfully:
+
+    ```shell-session
+    $ curl /var/run/docker.sock
+    ```
+
+2. Podman commands run successfully when redirected to the Docker socket:
+
+    ```shell-session
+    $ CONTAINER_HOST=/var/run/docker.sock podman ps
+    ```