Coder Desktop
Use Coder Desktop to work on your workspaces as though they're on your LAN, no port-forwarding required.
Note
Coder Desktop requires a Coder deployment running v2.20.0 or later.
Install Coder Desktop
-
Use Homebrew to install Coder Desktop:
brew install --cask coder/coder/coder-desktop
Alternatively, you can manually install Coder Desktop from the releases page.
-
Open Coder Desktop from the Applications directory.
-
The application is treated as a system VPN. macOS will prompt you to confirm with:
"Coder Desktop" would like to use a new network extension
Select Open System Settings.
-
In the Network Extensions system settings, enable the Coder Desktop extension.
-
Continue to the configuration section.
Do not install more than one copy of Coder Desktop.
To avoid system VPN configuration conflicts, only one copy of
Coder Desktop.app
should exist on your Mac, and it must remain in/Applications
.
Configure
Before you can use Coder Desktop, you will need to sign in.
-
Open the Desktop menu and select Sign in:
-
In the Sign In window, enter your Coder deployment's URL and select Next:
-
macOS: Select the link to your deployment's
/cli-auth
page to generate a session token.Windows: Select Generate a token via the Web UI.
-
In your web browser, you may be prompted to sign in to Coder with your credentials.
-
Copy the session token to the clipboard:
-
Paste the token in the Session Token field of the Sign In screen, then select Sign In:
-
macOS: Allow the VPN configuration for Coder Desktop if you are prompted:
-
Select the Coder icon in the menu bar (macOS) or system tray (Windows), and click the Coder Connect toggle to enable the connection.
This may take a few moments, as Coder Desktop will download the necessary components from the Coder server if they have been updated.
-
macOS: You may be prompted to enter your password to allow Coder Connect to start.
-
Coder Connect is now running!