|
1 | 1 | #Coder Desktop |
2 | 2 |
|
3 | 3 | Coder Desktop provides seamless access to your remote workspaces without the need to install a CLI or configure manual port forwarding. |
4 | | -Connect to workspace services using simple hostnames like`myworkspace.coder`, launch native applications with one click, and synchronize files between local and remote environments. |
| 4 | +Connect to workspace services using simple hostnames like`myworkspace.coder`, launch native applications with one click, |
| 5 | +and synchronize files between local and remote environments. |
5 | 6 |
|
6 | | ->[!NOTE] |
7 | | ->Coder Desktop requires a Coder deployment running[v2.20.0](https://github.com/coder/coder/releases/tag/v2.20.0) or later. |
| 7 | +Coder Desktop requires a Coder deployment running[v2.20.0](https://github.com/coder/coder/releases/tag/v2.20.0) or later. |
8 | 8 |
|
9 | 9 | ##Install Coder Desktop |
10 | 10 |
|
| 11 | +>[!IMPORTANT] |
| 12 | +>Coder Desktop can't connect through another VPN. |
| 13 | +> |
| 14 | +>Due to a[known issue](#coder-desktop-cant-connect-through-another-vpn), |
| 15 | +>if your Coder deployment is requires that you connect through a VPN, Desktop will timeout when it tries to connect. |
| 16 | +
|
11 | 17 | <divclass="tabs"> |
12 | 18 |
|
13 | 19 | You can install Coder Desktop on macOS or Windows. |
14 | 20 |
|
15 | 21 | ###macOS |
16 | 22 |
|
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 | | -
|
23 | 23 | 1. Use[Homebrew](https://brew.sh/) to install Coder Desktop: |
24 | 24 |
|
25 | 25 | ```shell |
@@ -135,17 +135,19 @@ Coder Desktop for [macOS](https://github.com/coder/coder-desktop-macos/issues) o |
135 | 135 |
|
136 | 136 | ###Known Issues |
137 | 137 |
|
138 | | -####Do not install more than one copy of Coder Desktop |
| 138 | +####macOS:Do not install more than one copy of Coder Desktop |
139 | 139 |
|
140 | 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 | 141 |
|
142 | | -####macOS:Coder Desktop can't connect through another VPN |
| 142 | +####Coder Desktop can't connect through another VPN |
143 | 143 |
|
144 | 144 | If the logged in Coder deployment requires a VPN to connect, Coder Connect can't establish communication through the VPN, |
145 | 145 | and will time out. |
146 | 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. |
| 147 | +This is due to known issues with how[macOS](https://github.com/coder/coder-desktop-macos/issues/201) and |
| 148 | +[Windows](https://github.com/coder/coder-desktop-windows/issues/147) |
| 149 | +network extensions communicate with each other. |
| 150 | +A resolution is in progress. |
149 | 151 |
|
150 | 152 | ##Next Steps |
151 | 153 |
|
|