diff --git a/docs/ides/remote-desktops.md b/docs/ides/remote-desktops.md index f9379f1f6f736..f7496a1d5620c 100644 --- a/docs/ides/remote-desktops.md +++ b/docs/ides/remote-desktops.md @@ -22,3 +22,26 @@ As a starting point, see the [desktop-container](https://github.com/bpmct/coder- - 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. + +As a starting point, see the [gcp-windows-rdp](https://github.com/matifali/coder-templates/tree/main/gcp-windows-rdp) community template. It builds and provisions a Windows Server workspace on GCP. + +Use the following command to forward the RDP port to your local machine: + +```console +coder port-forward --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`. +![windows-rdp](../images/ides/windows_rdp_client.png) + +> Note: Default username is `Administrator` and password is `coderRDP!`. diff --git a/docs/images/ides/windows_rdp_client.png b/docs/images/ides/windows_rdp_client.png new file mode 100644 index 0000000000000..11607a35f4f4e Binary files /dev/null and b/docs/images/ides/windows_rdp_client.png differ