|
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 | <div class="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 |
|
|
0 commit comments