mirror of
https://github.com/coder/coder.git
synced 2025-07-18 14:17:22 +00:00
101b62dc3e
followup to #16761 thanks @lucasmelin ! + thanks: @ethanndickson @Parkreiner @matifali @aqandrew - [x] update snippet - [x] find/replace - [x] spot-check [preview](https://coder.com/docs/@16761-gfm-callouts/admin/templates/managing-templates/schedule) (and others) --------- Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Co-authored-by: M Atif Ali <atif@coder.com>
70 lines
2.1 KiB
Markdown
70 lines
2.1 KiB
Markdown
# Remote Desktops
|
|
|
|
Built-in remote desktop is on the roadmap
|
|
([#2106](https://github.com/coder/coder/issues/2106)).
|
|
|
|
## VNC Desktop
|
|
|
|
The common way to use remote desktops with Coder is through VNC.
|
|
|
|
|
|
|
|
Workspace requirements:
|
|
|
|
- VNC server (e.g. [tigervnc](https://tigervnc.org/))
|
|
- VNC client (e.g. [novnc](https://novnc.com/info.html))
|
|
|
|
Installation instructions vary depending on your workspace's operating system,
|
|
platform, and build system.
|
|
|
|
As a starting point, see the
|
|
[desktop-container](https://github.com/bpmct/coder-templates/tree/main/desktop-container)
|
|
community template. It builds and provisions a Dockerized workspace with the
|
|
following software:
|
|
|
|
- Ubuntu 20.04
|
|
- TigerVNC server
|
|
- noVNC client
|
|
- XFCE Desktop
|
|
|
|
## RDP Desktop
|
|
|
|
To use RDP with Coder, you'll need to install an
|
|
[RDP client](https://docs.microsoft.com/en-us/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients)
|
|
on your local machine, and enable RDP on your workspace.
|
|
|
|
Use the following command to forward the RDP port to your local machine:
|
|
|
|
```console
|
|
coder port-forward <workspace-name> --tcp 3399:3389
|
|
```
|
|
|
|
Then, connect to your workspace via RDP:
|
|
|
|
```console
|
|
mstsc /v localhost:3399
|
|
```
|
|
|
|
Or use your favorite RDP client to connect to `localhost:3399`.
|
|
|
|
|
|
The default username is `Administrator` and password is `coderRDP!`.
|
|
|
|
## RDP Web
|
|
|
|
Our [WebRDP](https://registry.coder.com/modules/windows-rdp) module in the Coder
|
|
Registry adds a one-click button to open an RDP session in the browser. This
|
|
requires just a few lines of Terraform in your template, see the documentation
|
|
on our registry for setup.
|
|
|
|
|
|
|
|
## Amazon DCV Windows
|
|
|
|
Our [Amazon DCV Windows](https://registry.coder.com/modules/amazon-dcv-windows)
|
|
module adds a one-click button to open an Amazon DCV session in the browser.
|
|
This requires just a few lines of Terraform in your template, see the
|
|
documentation on our registry for setup.
|
|
|
|
|