|
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 a corporate VPN. |
| 13 | +> |
| 14 | +>Due to a[known issue](#coder-desktop-cant-connect-through-another-vpn), |
| 15 | +>if your Coder deployment requires that you connect through a corporate 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. |
@@ -113,15 +119,34 @@ Before you can use Coder Desktop, you will need to sign in. |
113 | 119 |
|
114 | 120 |  |
115 | 121 |
|
116 | | - This may take a few moments,as Coder Desktop will download the necessary components from the Coder server if they have been updated. |
| 122 | + This may take a few moments,because Coder Desktop will download the necessary components from the Coder server if they have been updated. |
117 | 123 |
|
118 | 124 | 1. macOS: You may be prompted to enter your password to allow Coder Connect to start. |
119 | 125 |
|
120 | 126 | 1. Coder Connect is now running! |
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 | +####macOS: 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 | +####Coder Desktop can't connect through another VPN |
| 143 | + |
| 144 | +If the logged in Coder deployment requires a corporate VPN to connect, Coder Connect can't establish communication |
| 145 | +through the VPN, and will time out. |
| 146 | + |
| 147 | +This is due to known issues with[macOS](https://github.com/coder/coder-desktop-macos/issues/201) and |
| 148 | +[Windows](https://github.com/coder/coder-desktop-windows/issues/147) networking. |
| 149 | +A resolution is in progress. |
125 | 150 |
|
126 | 151 | ##Next Steps |
127 | 152 |
|
|