diff --git a/public/docs-static/img/how-to-guides/enable-ssh-access.png b/public/docs-static/img/how-to-guides/enable-ssh-access.png
new file mode 100644
index 00000000..b16a6c84
Binary files /dev/null and b/public/docs-static/img/how-to-guides/enable-ssh-access.png differ
diff --git a/src/pages/how-to/cli.mdx b/src/pages/how-to/cli.mdx
index 21d4a3a3..dd5e2a36 100644
--- a/src/pages/how-to/cli.mdx
+++ b/src/pages/how-to/cli.mdx
@@ -381,6 +381,16 @@ If you the remote peer agent is running the ssh service on a different port, you
 sudo netbird ssh -p 3434 user@100.119.230.104
 ```
 
+#### Troubleshooting
+When you try to connect via `netbird ssh <peer>`, errors can occur. Please enable `ssh` support when joining a peer to your account. 
+```shell
+netbird up --allow-server-ssh
+```
+This will allow the the `SSH Access feature` to work when enabled in the dashboard, under Peers > _your_peer_ > SSH Access.
+<p>
+    <img src="/docs-static/img/how-to/enable-ssh-access.png" alt="high-level-dia" className="imagewrapper-big"/>
+</p>
+
 ### version
 Outputs the `netbird` command version.
 #### Usage