coder · ammario · Aug 7, 2022 · Aug 7, 2022
diff --git a/docs/ides.md b/docs/ides.md
@@ -79,9 +79,6 @@ Connection and connect to your Coder workspace.](./ides/configuring-gateway.md)
 
 Web IDEs (code-server, JetBrains Projector, VNC, etc.) are defined in the template. See [configuring IDEs](./ides/configuring-web-ides.md).
 
-## Port Forwarding
+## Up next
 
-Port Forwarding lets developers securely access processes on their Coder
-workspace from a local machine. A common use case is testing front-end
-applications in a browser at `http://localhost:<yourforwardedport>` See
-[configuring Port Forwarding](./ides/configuring-port-forwarding.md).
+- Learn about [Port Forwarding](./port-forwarding.md)
diff --git a/docs/ides/configuring-port-forwarding.md b/docs/ides/configuring-port-forwarding.md
diff --git a/docs/images/icons/port-forward.svg b/docs/images/icons/port-forward.svg
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -94,6 +94,12 @@
         }
       ]
     },
+    {
+      "title": "Port Forwarding",
+      "description": "Learn how to forward ports in Coder",
+      "path": "./port-forwarding.md",
+      "icon_path": "./images/icons/port-forward.svg"
+    },
     {
       "title": "Dotfiles",
       "description": "Learn how to personalize your workspace",

diff --git a/docs/port-forwarding.md b/docs/port-forwarding.md
@@ -0,0 +1,33 @@
+# Port Forwarding
+
+Port forwarding lets developers securely access processes on their Coder
+workspace from a local machine. A common use case is testing web
+applications in a browser.
+
+There are two ways to forward ports in Coder:
+
+- The `coder port-forward` command
+- SSH
+
+The `coder port-forward` command is generally more performant.
+
+## coder port-forward
+
+Forward the remote TCP port `8080` to local port `8000` like so:
+
+```console
+coder port-forward myworkspace --tcp 8000:8080
+```
+
+For more examples, see `coder port-forward --help`.
+
+## SSH
+
+First, [configure SSH](../ides.md#ssh-configuration) on your
+local machine. Then, use `ssh` to forward like so:
+
+```console
+ssh -L 8080:localhost:8000 coder.myworkspace
+```
+
+You can read more on SSH port forwarding [here](https://www.ssh.com/academy/ssh/tunneling/example).