coder · matifali · Mar 4, 2025 · Feb 12, 2025 · Feb 12, 2025 · Feb 12, 2025
diff --git a/docs/images/icons/computer-code.svg b/docs/images/icons/computer-code.svg
diff --git a/docs/images/user-guides/desktop/coder-desktop-pre-sign-in.png b/docs/images/user-guides/desktop/coder-desktop-pre-sign-in.png
diff --git a/docs/images/user-guides/desktop/coder-desktop-session-token.png b/docs/images/user-guides/desktop/coder-desktop-session-token.png
diff --git a/docs/images/user-guides/desktop/coder-desktop-sign-in.png b/docs/images/user-guides/desktop/coder-desktop-sign-in.png
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -158,6 +158,13 @@
 						}
 					]
 				},
+				{
+					"title": "Coder Desktop",
+					"description": "Use Coder Desktop to access your workspace like it's a local machine",
+					"path": "./user-guides/desktop/index.md",
+					"icon_path": "./images/icons/computer-code.svg",
+					"state": ["alpha"]
+				},
 				{
 					"title": "Workspace Management",
 					"description": "Manage workspaces",

diff --git a/docs/user-guides/desktop/index.md b/docs/user-guides/desktop/index.md
@@ -0,0 +1,76 @@
+# Coder Desktop
+
+Use Coder Desktop to work on your workspaces as though they're on your LAN, no
+port-forwarding required.
+
+## Install Coder Desktop
+
+<div class="tabs">
+
+You can install Coder Desktop on macOS or Windows.
+
+### macOS
+
+1. Use [Homebrew](https://brew.sh/) to install Coder Desktop:
+
+   ```shell
+   brew install --cask coder/coder/coder-desktop
+   ```
+
+1. Open Coder Desktop from the Applications directory and when macOS asks if you want to open it, select **Open**.
+
+1. The application connects as a VPN. macOS will prompt you to confirm with:
+
+   **"Coder Desktop" would like to use a new network extension**
+
+   Select **Open System Settings**.
+
+1. In your **Network Extensions** system settings, enable the Coder Desktop extension.
+
+1. Continue to the [configuration section](#configure).
+
+### Windows
+
+Download from there.
+
+</div>
+
+## Configure
+    
+Before you can use Coder Desktop, you will need to log in.
+
+1. Open the Desktop menu again and select **Sign in**:
+
+   ![Coder Desktop menu before the user signs in](../../images/user-guides/desktop/coder-desktop-pre-sign-in.png)
+
+1. In the **Sign In** window, enter your Coder deployment's URL and select **Next**:
+
+   ![Coder Desktop sign in](../../images/user-guides/desktop/coder-desktop-sign-in.png)
+
+1. Select the link to your deployment's `/cli-auth` page to generate a [session token](../../admin/users/sessions-tokens.md).
+
+1. In your web browser, enter your credentials:
+
+   <Image height="412px" src="../../images/templates/coder-login-web.png" alt="Log in to your Coder deployment" align="center" />
+
+1. Copy the session token to the clipboard:
+
+   <Image height="472px" src="../../images/templates/coder-session-token.png" alt="Copy session token" align="center" />
+
+1. Paste the token in the **Session Token** box of the **Sign In** screen, then select **Sign In**:
+
+   ![Paste the session token in to sign in](../../images/user-guides/desktop/coder-desktop-session-token.png)
+
+1. Allow the VPN configuration for Coder Desktop if your OS prompts you.
+
+1. Coder Desktop is now running!
+
+   Select the Coder icon in the menu bar (macOS) or system tray (Windows) to enable [CoderVPN](#codervpn).
+
+## Workspaces from Coder Desktop
+
+Placeholder for what users can do with workspaces from Coder Desktop

+## CoderVPN
+
+Placeholder for some information about CoderVPN