Coder Desktop provides seamless access to your remote workspaces through a native application. Connect to workspace services using simple hostnames likemyworkspace.coder, launch applications with one click, and synchronize files between local and remote environments—all without installing a CLI or configuring manual port forwarding.

What You'll Need

• A Coder deployment runningv2.20.0 orlater
• Administrator privileges on your local machine (for VPN extension installation)
• Access to your Coder deployment URL

Quick Start

1. Install:brew install --cask coder/coder/coder-desktop (macOS) orwinget install Coder.CoderDesktop (Windows)
2. Open Coder Desktop and approve any system prompts to complete the installation.
3. Sign in with your deployment URL and session token
4. Enable "Coder Connect" toggle
5. Access workspaces atworkspace-name.coder

How It Works

Coder Connect, the primary component of Coder Desktop, creates a secure tunnel to your Coder deployment, allowing you to:

• Access workspaces directly: Connect viaworkspace-name.coder hostnames
• Use any application: SSH clients, browsers, IDEs work seamlessly
• Sync files: Bidirectional sync between local and remote directories
• Work offline: Edit files locally, sync when reconnected

The VPN extension routes only Coder traffic—your other internet activity remains unchanged.

Installation

Testing Your Connection

Once connected, test access to your workspaces:

Troubleshooting

Connection Issues

Can't connect to workspace

• Verify Coder Connect is enabled (toggle should be ON)
• Check that your deployment URL is correct
• Ensure your session token hasn't expired
• Try disconnecting and reconnecting Coder Connect

VPN extension not working

• Restart Coder Desktop
• Check system permissions for network extensions
• Ensure only one copy of Coder Desktop is installed

Getting Help

If you encounter issues not covered here:

• File an issue:macOS |Windows |General
• Community support:Discord

Uninstalling

Next Steps