HomeUser GuidesAccess WorkspacesRemote Desktop

Remote Desktop

On this page

RDP

The most common way to get a GUI-based connection to a Windows workspace is by using Remote Desktop Protocol (RDP).

To use RDP with Coder, you'll need to install an RDP client on your local machine, and enable RDP on your workspace.

Coder Desktop's Coder Connect feature creates a connection to your workspaces in the background. Use your favorite RDP client to connect to <workspace-name>.coder.

You can use the RDP Desktop module to add a single-click button to open an RDP session in the browser.

You can also use a URI handler to launch an RDP session directly.

The URI format is:

coder://<your Coder server name>/v0/open/ws/<workspace name>/agent/<agent name>/rdp?username=<username>&password=<password>

For example:

coder://coder.example.com/v0/open/ws/myworkspace/agent/main/rdp?username=Administrator&password=coderRDP!

To include a Coder Desktop button on the workspace dashboard page, add a coder_app resource to the template:

locals {
  server_name = regex("https?:\\/\\/([^\\/]+)", data.coder_workspace.me.access_url)[0]
}

resource "coder_app" "rdp-coder-desktop" {
  agent_id     = resource.coder_agent.main.id
  slug         = "rdp-desktop"
  display_name = "RDP Desktop"
  url          = "coder://${local.server_name}/v0/open/ws/${data.coder_workspace.me.name}/agent/main/rdp?username=Administrator&password=coderRDP!"
  icon         = "/icon/desktop.svg"
  external     = true
}

Note

Some versions of Windows, including Windows Server 2022, do not communicate correctly over UDP when using Coder Connect because they do not respect the maximum transmission unit (MTU) of the link. When this happens, the RDP client will appear to connect, but displays a blank screen.

To avoid this error, Coder's Windows RDP module disables RDP over UDP automatically.

To disable RDP over UDP manually, run the following in PowerShell:

New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services' -Name "SelectTransport" -Value 1 -PropertyType DWORD -Force
Restart-Service -Name "TermService" -Force

Note

The default username is Administrator and the password is coderRDP!.

Amazon DCV

Our Amazon DCV Windows installs and configures the Amazon DCV server for seamless remote desktop access. It allows connecting through the both the Amazon DCV desktop clients and a web browser.

Connect using the Amazon DCV Desktop client by forwarding the DCV port to your local machine:

Coder Desktop's Coder Connect feature creates a connection to your workspaces in the background. Use DCV client to connect to <workspace-name>.coder:8443.

Amazon DCV

VNC

The common way to connect to a desktop session of a Linux workspace is to use a VNC client. The VNC client can be installed on your local machine or accessed through a web browser. There is an additional requirement to install the VNC server on the workspace.

Installation instructions vary depending on your workspace's operating system, platform, and build system. Refer to the enterprise-desktop image for a starting point which can be used to provision a Dockerized workspace with the following software:

Ubuntu 24.04
XFCE Desktop
KasmVNC Server and Web Client

Use a VNC client (e.g., TigerVNC) by forwarding the VNC port to your local machine.

Coder Desktop

Coder Desktop's Coder Connect feature allows you to connect to your workspace's VNC server at <workspace-name>.coder:5900.

CLI

Use the following command to forward the VNC port to your local machine:

coder port-forward <workspace-name> --tcp 5900:5900

Now you can connect to your workspace's VNC server using a VNC client at localhost:5900.

VNC Desktop in Coder