You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/user-guides/desktop/index.md
+25-1Lines changed: 25 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,6 +14,12 @@ You can install Coder Desktop on macOS or Windows.
14
14
15
15
###macOS
16
16
17
+
>[!IMPORTANT]
18
+
>Coder Desktop can't connect through another VPN.
19
+
>
20
+
>Due to a[known issue](#mac-coder-desktop-cant-connect-through-another-vpn),
21
+
>if your Coder deployment is requires that you connect through a VPN, Desktop will timeout when it tries to connect.
22
+
17
23
1. Use[Homebrew](https://brew.sh/) to install Coder Desktop:
18
24
19
25
```shell
@@ -121,7 +127,25 @@ Before you can use Coder Desktop, you will need to sign in.
121
127
122
128
##Troubleshooting
123
129
124
-
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`.
130
+
If you encounter an issue with Coder Desktop that is not listed here, file an issue in the GitHub repository for
131
+
Coder Desktop for[macOS](https://github.com/coder/coder-desktop-macos/issues) or
132
+
[Windows](https://github.com/coder/coder-desktop-windows/issues), in the
133
+
[main Coder repository](https://github.com/coder/coder/issues), or consult the
134
+
[community on Discord](https://coder.com/chat).
135
+
136
+
###Known Issues
137
+
138
+
####Do not install more than one copy of Coder Desktop
139
+
140
+
To avoid system VPN configuration conflicts, only one copy of`Coder Desktop.app` should exist on your Mac, and it must remain in`/Applications`.
141
+
142
+
####macOS: Coder Desktop can't connect through another VPN
143
+
144
+
If the logged in Coder deployment requires a VPN to connect, Coder Connect can't establish communication through the VPN,
145
+
and will time out.
146
+
147
+
This is due to a[known issue](https://github.com/coder/coder-desktop-macos/issues/201) with how macOS network extensions
148
+
communicate with each other and a resolution is in progress.