Jul 8, 2025 · Jun 23, 2025 · Jun 27, 2025 · Jun 30, 2025 · Jul 1, 2025 · Jul 1, 2025
diff --git a/...s/user-guides/amazon-dcv-windows-demo.png → ...mote-desktops/amazon-dcv-windows-demo.png b/...s/user-guides/amazon-dcv-windows-demo.png → ...mote-desktops/amazon-dcv-windows-demo.png
diff --git a/docs/images/user-guides/remote-desktops/rdp-button-and-window.png b/docs/images/user-guides/remote-desktops/rdp-button-and-window.png
diff --git a/docs/images/vnc-desktop.png → ...er-guides/remote-desktops/vnc-desktop.png b/docs/images/vnc-desktop.png → ...er-guides/remote-desktops/vnc-desktop.png
diff --git a/docs/images/user-guides/web-rdp-demo.png → ...r-guides/remote-desktops/web-rdp-demo.png b/docs/images/user-guides/web-rdp-demo.png → ...r-guides/remote-desktops/web-rdp-demo.png
diff --git a/docs/images/ides/windows_rdp_client.png → ...es/remote-desktops/windows_rdp_client.png b/docs/images/ides/windows_rdp_client.png → ...es/remote-desktops/windows_rdp_client.png
diff --git a/docs/user-guides/workspace-access/remote-desktops.md b/docs/user-guides/workspace-access/remote-desktops.md
 # Remote Desktops

 ##VNC Desktop
 ##RDP

 The common way touse remote desktops with Coderisthrough VNC.
 Themostcommon way toget a GUI-based connection to a Windows workspaceisby using Remote Desktop Protocol (RDP).

 ![VNC Desktop in Coder](../../images/vnc-desktop.png)

 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
 [enterprise-desktop](https://github.com/coder/images/tree/main/images/desktop)
 image. It can be used to provision a Dockerized workspace with the
 following software:

 - Ubuntu 24.04
 - XFCE Desktop
 - KasmVNC Server and Web Client
 <div class="tabs">

 ## RDPDesktop
 ###Desktop Client

 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.

 <div class="tabs">

 ### CLI
 #### Coder Desktop

 Use the following commandtoforwardthe RDPport toyour local machine:
 [Coder Desktop](../desktop/index.md)'s **Coder Connect** feature creates a connectiontoyour workspaces inthebackground. Use your favoriteRDPclient toconnect to `<workspace-name>.coder`.

 ```console
 coder port-forward <workspace-name> --tcp 3399:3389
 ```

 Then, connect to your workspace via RDP at `localhost:3399`.
 ![windows-rdp](../../images/ides/windows_rdp_client.png)
 You can use the [RDP Desktop](https://registry.coder.com/modules/coder/local-windows-rdp) module to add a single-click button to open an RDP session in the browser.

 ###RDPwith CoderDesktop
 ![RDP Desktop Button](../../images/user-guides/remote-desktops/rdp-button-and-window.png)

 [Coder Desktop](../desktop/index.md)'s Coder Connect feature creates a connection to your workspaces in the background.
 There is no need for port forwarding when it is enabled.

 Use your favorite RDP client to connect to `<workspace-name>.coder` instead of `localhost:3399`.

 > [!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](https://registry.coder.com/modules/windows-rdp) module
 > [disables RDP over UDP automatically](https://github.com/coder/registry/blob/b58bfebcf3bcdcde4f06a183f92eb3e01842d270/registry/coder/modules/windows-rdp/powershell-installation-script.tftpl#L22).
 >
 > To disable RDP over UDP, run the following in PowerShell:
 >
 > ```powershell
 > New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services' -Name "SelectTransport" -Value 1 -PropertyType DWORD -Force
 > Restart-Service -Name "TermService" -Force
 > ```

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

 The URI format is:

 resource "coder_app" "rdp-coder-desktop" {
  agent_id     = resource.coder_agent.main.id
  slug         = "rdp-desktop"
  display_name = "RDPwith CoderDesktop"
  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
 }
 ```

 #### CLI

 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 at `localhost:3399`.
 ![windows-rdp](../../images/user-guides/remote-desktops/windows_rdp_client.png)

 </div>s

 > [!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](https://registry.coder.com/modules/windows-rdp) module [disables RDP over UDP automatically](https://github.com/coder/registry/blob/b58bfebcf3bcdcde4f06a183f92eb3e01842d270/registry/coder/modules/windows-rdp/powershell-installation-script.tftpl#L22).
 >
 > To disable RDP over UDP manually, run the following in PowerShell:
 >
 > ```powershell
 > New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services' -Name "SelectTransport" -Value 1 -PropertyType DWORD -Force
 > Restart-Service -Name "TermService" -Force
 > ```

 ### Browser

 Our [RDP Web](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.

 ![Windows RDP Web](../../images/user-guides/remote-desktops/web-rdp-demo.png)

 </div>

 > [!NOTE]
 > The default username is `Administrator` and the password is `coderRDP!`.

 ## RDP Web
 ## Amazon DCV

 Our [Amazon DCV Windows](https://registry.coder.com/modules/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](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting.html) and a [web browser](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting-browser-connect.html).

 <div class="tabs">

 ### Desktop Client

 Connect using the [Amazon DCV Desktop client](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting.html) by forwarding the DCV port to your local machine:

 <div class="tabs">

 #### Coder Desktop

 [Coder Desktop](../desktop/index.md)'s **Coder Connect** feature creates a connection to your workspaces in the background. Use DCV client to connect to `<workspace-name>.coder:8443`.

 #### CLI

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

 ```console
 coder port-forward <workspace-name> --tcp 8443:8443
 ```

 </div>

 ### Browser

 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.

 </div>

 Our [Windows RDP](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](../../images/user-guides/remote-desktops/amazon-dcv-windows-demo.png)

 ![Windows RDP Module in a Workspace](../../images/user-guides/web-rdp-demo.png)
 ## VNC

 ## Amazon DCV Windows
 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.

 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.
 Installation instructions vary depending on your workspace's operating system, platform, and build system. Refer to the [enterprise-desktop](https://github.com/coder/images/tree/main/images/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

 <div class="tabs">

 ### Desktop Client

 Use a VNC client (e.g., [TigerVNC](https://tigervnc.org/)) by forwarding the VNC port to your local machine.

 <div class="tab">

 #### Coder Desktop

 [Coder Desktop](../desktop/index.md)'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:

 ```bash
 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`.

 </div>

 ### Browser

 The [KasmVNC module](https://registry.coder.com/modules/coder/kasmvnc) allows browser-based access to your workspace by installing and configuring the [KasmVNC](https://github.com/kasmtech/KasmVNC) server and web client.

 </div>

 ![Amazon DCV Windows Moduleina Workspace](../../images/user-guides/amazon-dcv-windows-demo.png)
 ![VNC DesktopinCoder](../../images/user-guides/remote-desktops/vnc-desktop.png)
Original file line number	Diff line number	Diff line change
		@@ -1,70 +1,28 @@
		# Remote Desktops

		##VNC Desktop
		##RDP

		The common way touse remote desktops with Coderisthrough VNC.
		Themostcommon way toget a GUI-based connection to a Windows workspaceisby using Remote Desktop Protocol (RDP).

		![VNC Desktop in Coder](../../images/vnc-desktop.png)

		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
		[enterprise-desktop](https://github.com/coder/images/tree/main/images/desktop)
		image. It can be used to provision a Dockerized workspace with the
		following software:

		- Ubuntu 24.04
		- XFCE Desktop
		- KasmVNC Server and Web Client
		<div class="tabs">

		## RDPDesktop
		###Desktop Client

		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.

		<div class="tabs">

		### CLI
		#### Coder Desktop

		Use the following commandtoforwardthe RDPport toyour local machine:
		[Coder Desktop](../desktop/index.md)'s Coder Connect feature creates a connectiontoyour workspaces inthebackground. Use your favoriteRDPclient toconnect to `<workspace-name>.coder`.

		```console
		coder port-forward <workspace-name> --tcp 3399:3389
		```

		Then, connect to your workspace via RDP at `localhost:3399`.
		![windows-rdp](../../images/ides/windows_rdp_client.png)
		You can use the [RDP Desktop](https://registry.coder.com/modules/coder/local-windows-rdp) module to add a single-click button to open an RDP session in the browser.

		###RDPwith CoderDesktop
		![RDP Desktop Button](../../images/user-guides/remote-desktops/rdp-button-and-window.png)

		[Coder Desktop](../desktop/index.md)'s Coder Connect feature creates a connection to your workspaces in the background.
		There is no need for port forwarding when it is enabled.

		Use your favorite RDP client to connect to `<workspace-name>.coder` instead of `localhost:3399`.

		> [!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](https://registry.coder.com/modules/windows-rdp) module
		> [disables RDP over UDP automatically](https://github.com/coder/registry/blob/b58bfebcf3bcdcde4f06a183f92eb3e01842d270/registry/coder/modules/windows-rdp/powershell-installation-script.tftpl#L22).
		>
		> To disable RDP over UDP, run the following in PowerShell:
		>
		> ```powershell
		> New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services' -Name "SelectTransport" -Value 1 -PropertyType DWORD -Force
		> Restart-Service -Name "TermService" -Force
		> ```

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

		The URI format is:

Expand All		@@ -88,32 +46,121 @@ locals {
		resource "coder_app" "rdp-coder-desktop" {
		agent_id = resource.coder_agent.main.id
		slug = "rdp-desktop"
		display_name = "RDPwith CoderDesktop"
		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
		}
		```

		#### CLI

		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 at `localhost:3399`.
		![windows-rdp](../../images/user-guides/remote-desktops/windows_rdp_client.png)

		</div>s

		> [!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](https://registry.coder.com/modules/windows-rdp) module [disables RDP over UDP automatically](https://github.com/coder/registry/blob/b58bfebcf3bcdcde4f06a183f92eb3e01842d270/registry/coder/modules/windows-rdp/powershell-installation-script.tftpl#L22).
		>
		> To disable RDP over UDP manually, run the following in PowerShell:
		>
		> ```powershell
		> New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services' -Name "SelectTransport" -Value 1 -PropertyType DWORD -Force
		> Restart-Service -Name "TermService" -Force
		> ```

		### Browser

		Our [RDP Web](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.

		![Windows RDP Web](../../images/user-guides/remote-desktops/web-rdp-demo.png)

		</div>

		> [!NOTE]
		> The default username is `Administrator` and the password is `coderRDP!`.

		## RDP Web
		## Amazon DCV

		Our [Amazon DCV Windows](https://registry.coder.com/modules/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](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting.html) and a [web browser](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting-browser-connect.html).

		<div class="tabs">

		### Desktop Client

		Connect using the [Amazon DCV Desktop client](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting.html) by forwarding the DCV port to your local machine:

		<div class="tabs">

		#### Coder Desktop

		[Coder Desktop](../desktop/index.md)'s Coder Connect feature creates a connection to your workspaces in the background. Use DCV client to connect to `<workspace-name>.coder:8443`.

		#### CLI

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

		```console
		coder port-forward <workspace-name> --tcp 8443:8443
		```

		</div>

		### Browser

		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.

		</div>

		Our [Windows RDP](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](../../images/user-guides/remote-desktops/amazon-dcv-windows-demo.png)

		![Windows RDP Module in a Workspace](../../images/user-guides/web-rdp-demo.png)
		## VNC

		## Amazon DCV Windows
		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.

		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.
		Installation instructions vary depending on your workspace's operating system, platform, and build system. Refer to the [enterprise-desktop](https://github.com/coder/images/tree/main/images/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

		<div class="tabs">

		### Desktop Client

		Use a VNC client (e.g., [TigerVNC](https://tigervnc.org/)) by forwarding the VNC port to your local machine.

		<div class="tab">

		#### Coder Desktop

		[Coder Desktop](../desktop/index.md)'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:

		```bash
		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`.

		</div>

		### Browser

		The [KasmVNC module](https://registry.coder.com/modules/coder/kasmvnc) allows browser-based access to your workspace by installing and configuring the [KasmVNC](https://github.com/kasmtech/KasmVNC) server and web client.

		</div>

		![Amazon DCV Windows Moduleina Workspace](../../images/user-guides/amazon-dcv-windows-demo.png)
		![VNC DesktopinCoder](../../images/user-guides/remote-desktops/vnc-desktop.png)