Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

docs: document issue with macos coder desktop behind vpn#18855

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
EdwardAngert merged 4 commits intomainfrom201-desktop-mac-vpn
Jul 14, 2025
Merged
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 30 additions & 5 deletionsdocs/user-guides/desktop/index.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,19 @@
# Coder Desktop

Coder Desktop provides seamless access to your remote workspaces without the need to install a CLI or configure manual port forwarding.
Connect to workspace services using simple hostnames like `myworkspace.coder`, launch native applications with one click, and synchronize files between local and remote environments.
Connect to workspace services using simple hostnames like `myworkspace.coder`, launch native applications with one click,
and synchronize files between local and remote environments.

> [!NOTE]
> Coder Desktop requires a Coder deployment running [v2.20.0](https://github.com/coder/coder/releases/tag/v2.20.0) or later.
Coder Desktop requires a Coder deployment running [v2.20.0](https://github.com/coder/coder/releases/tag/v2.20.0) or later.

## Install Coder Desktop

> [!IMPORTANT]
> Coder Desktop can't connect through a corporate VPN.
>
> Due to a [known issue](#coder-desktop-cant-connect-through-another-vpn),
> if your Coder deployment requires that you connect through a corporate VPN, Desktop will timeout when it tries to connect.

<div class="tabs">

You can install Coder Desktop on macOS or Windows.
Expand DownExpand Up@@ -113,15 +119,34 @@ Before you can use Coder Desktop, you will need to sign in.

![Coder Desktop on Windows - enable Coder Connect](../../images/user-guides/desktop/coder-desktop-win-enable-coder-connect.png)

This may take a few moments,as Coder Desktop will download the necessary components from the Coder server if they have been updated.
This may take a few moments,because Coder Desktop will download the necessary components from the Coder server if they have been updated.

1. macOS: You may be prompted to enter your password to allow Coder Connect to start.

1. Coder Connect is now running!

## Troubleshooting

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`.
If you encounter an issue with Coder Desktop that is not listed here, file an issue in the GitHub repository for
Coder Desktop for [macOS](https://github.com/coder/coder-desktop-macos/issues) or
[Windows](https://github.com/coder/coder-desktop-windows/issues), in the
[main Coder repository](https://github.com/coder/coder/issues), or consult the
[community on Discord](https://coder.com/chat).

### Known Issues

#### macOS: 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`.

#### Coder Desktop can't connect through another VPN

If the logged in Coder deployment requires a corporate VPN to connect, Coder Connect can't establish communication
through the VPN, and will time out.

This is due to known issues with [macOS](https://github.com/coder/coder-desktop-macos/issues/201) and
[Windows](https://github.com/coder/coder-desktop-windows/issues/147) networking.
A resolution is in progress.

## Next Steps

Expand Down
Loading
[8]ページ先頭
©2009-2025 Movatter.jp