Skip to content

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.

Sign up for GitHub

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

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jul 14, 2025
Merged

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

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
66e71d5
macos vpn issue
EdwardAngert Jul 14, 2025
5c38c7b
windows vpn issue too
EdwardAngert Jul 14, 2025
1f84010
Update docs/user-guides/desktop/index.md
EdwardAngert Jul 14, 2025
5cb39bb
corp. vpn
EdwardAngert Jul 14, 2025
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
Prev Previous commit
corp. vpn
  • Loading branch information
@EdwardAngert
EdwardAngert committed Jul 14, 2025
commit 5cb39bbaff02dbff248eb75e83516fda658cf274
13 changes: 6 additions & 7 deletions docs/user-guides/desktop/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Coder Desktop requires a Coder deployment running [v2.20.0](https://github.com/c
## Install Coder Desktop

> [!IMPORTANT]
> Coder Desktop can't connect through another VPN.
> 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.
Expand Down Expand Up @@ -119,7 +119,7 @@ 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.

Expand All @@ -141,12 +141,11 @@ To avoid system VPN configuration conflicts, only one copy of `Coder Desktop.app

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

If the logged in Coder deployment requires a VPN to connect, Coder Connect can't establish communication through the VPN,
and will time out.
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 how [macOS](https://github.com/coder/coder-desktop-macos/issues/201) and
[Windows](https://github.com/coder/coder-desktop-windows/issues/147)
network extensions communicate with each other.
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
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy