Skip to content

Commit 1d5bfe1

Browse files
authored
Apply suggestions from code review
1 parent 3bb1491 commit 1d5bfe1

File tree

1 file changed

+17
-9
lines changed

1 file changed

+17
-9
lines changed

docs/user-guides/workspace-access/remote-desktops.md

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -47,18 +47,26 @@ Or use your favorite RDP client to connect to `localhost:3399`.
4747

4848
The default username is `Administrator` and password is `coderRDP!`.
4949

50-
### Coder Desktop (Beta)
50+
### RDP with Coder Desktop (Beta)
5151

52-
[Coder Desktop](../desktop)'s _Coder Connect_ feature creates a connection to your workspaces in the background. There
53-
is no need for port forwarding when enabled. Use your favorite RDP client to connect to `<workspace-name>.coder` instead
54-
of `localhost:3399`.
52+
[Coder Desktop](../desktop/index.md)'s Coder Connect feature creates a connection to your workspaces in the background.
53+
There is no need for port forwarding when it is enabled.
54+
55+
Use your favorite RDP client to connect to `<workspace-name>.coder` instead of `localhost:3399`.
5556

5657
> [!NOTE]
57-
> We have identified that some versions of Windows, including Windows Server 2022, do not communicate correctly over UDP
58-
> when using Coder Connect as they do not respect the maximum transmission unit (MTU) of the link. When this happens the
59-
> RDP client will appear to connect, but show a blank screen. We recommend you
60-
> [disable RDP over UDP on your Windows workspaces](https://github.com/coder/registry/blob/b58bfebcf3bcdcde4f06a183f92eb3e01842d270/registry/coder/modules/windows-rdp/powershell-installation-script.tftpl#L22).
61-
> Coder's [Windows RDP](https://registry.coder.com/modules/windows-rdp) module does this automatically.
58+
> Some versions of Windows, including Windows Server 2022, do not communicate correctly over UDP
59+
> when using Coder Connect because they do not respect the maximum transmission unit (MTU) of the link.
60+
> When this happens the RDP client will appear to connect, but displays a blank screen.
61+
>
62+
> To avoid this error, Coder's [Windows RDP](https://registry.coder.com/modules/windows-rdp) module
63+
> [disables RDP over UDP automatically](https://github.com/coder/registry/blob/b58bfebcf3bcdcde4f06a183f92eb3e01842d270/registry/coder/modules/windows-rdp/powershell-installation-script.tftpl#L22).
64+
>
65+
> To manually disable RDP over UDP, run the following in PowerShell:
66+
>
67+
> ```powershell
68+
> New-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services' -Name "SelectTransport" -Value 1 -PropertyType DWORD -Force
69+
> ```
6270
6371
You can also use a URI handler to directly launch an RDP session without setting up port-forwarding.
6472

0 commit comments

Comments
 (0)