From bfa8a12980832fb8482dd9bf93b00eefc0f1c40c Mon Sep 17 00:00:00 2001
From: aescaler-raft <128422965+aescaler-raft@users.noreply.github.com>
Date: Fri, 28 Apr 2023 17:41:31 -0400
Subject: [PATCH] add(docs): podman instructions for macOS (#1257)

---
 docs/usage/advanced/podman.md | 41 +++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/usage/advanced/podman.md b/docs/usage/advanced/podman.md
index ff42f2f7..75c96911 100644
--- a/docs/usage/advanced/podman.md
+++ b/docs/usage/advanced/podman.md
@@ -93,6 +93,47 @@ export DOCKER_SOCK=/run/user/1000/podman/podman.sock
 k3d cluster create
 ```
 
+### macOS
+
+Initialize a podman machine if not done already
+
+```
+podman machine init
+```
+
+Or start an already existing podman machine
+
+```
+podman machine start
+```
+
+Grab connection details 
+> note: root connection details must be used
+
+```
+podman system connection ls
+Name                         URI                                                         Identity                                      Default
+podman-machine-default       ssh://core@localhost:53685/run/user/501/podman/podman.sock  /Users/myusername/.ssh/podman-machine-default  true
+podman-machine-default-root  ssh://root@localhost:53685/run/podman/podman.sock           /Users/myusername/.ssh/podman-machine-default  false
+```
+
+Edit your OpenSSH config file to specify the IdentityFile
+
+```
+vim ~/.ssh/config
+
+Host localhost
+	IdentityFile /Users/myusername/.ssh/podman-machine-default
+```
+
+Export the docker environment variables referenced above and create the cluster
+
+```
+export DOCKER_HOST=ssh://root@localhost:53685
+export DOCKER_SOCK=/run/podman/podman.sock
+k3d cluster create
+```
+
 ### Podman network
 
 The default `podman` network has dns disabled. To allow k3d cluster nodes to communicate with dns a new network must be created.