@@ -15,38 +15,33 @@ Installation instructions vary depending on your workspace's operating system,
15
15
platform, and build system.
16
16
17
17
As a starting point, see the
18
- [ desktop-container ] ( https://github.com/bpmct/ coder-templates/ tree/main/desktop-container )
19
- community template . It builds and provisions a Dockerized workspace with the
18
+ [ enterprise-desktop ] ( https://github.com/coder/images/ tree/main/images/ desktop )
19
+ image . It can be used to provision a Dockerized workspace with the
20
20
following software:
21
21
22
- - Ubuntu 20.04
23
- - TigerVNC server
24
- - noVNC client
22
+ - Ubuntu 24.04
25
23
- XFCE Desktop
24
+ - KasmVNC Server and Web Client
26
25
27
26
## RDP Desktop
28
27
29
28
To use RDP with Coder, you'll need to install an
30
29
[ RDP client] ( https://docs.microsoft.com/en-us/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients )
31
30
on your local machine, and enable RDP on your workspace.
32
31
33
- Use the following command to forward the RDP port to your local machine:
32
+ < div class = " tabs " >
34
33
35
- ``` console
36
- coder port-forward <workspace-name> --tcp 3399:3389
37
- ```
34
+ ### CLI
38
35
39
- Then, connect to your workspace via RDP:
36
+ Use the following command to forward the RDP port to your local machine :
40
37
41
38
``` console
42
- mstsc /v localhost: 3399
39
+ coder port-forward <workspace-name> --tcp 3399:3389
43
40
```
44
41
45
- Or use your favorite RDP client to connect to ` localhost:3399 ` .
42
+ Then, connect to your workspace via RDP at ` localhost:3399 ` .
46
43
![ windows-rdp] ( ../../images/ides/windows_rdp_client.png )
47
44
48
- The default username is ` Administrator ` and password is ` coderRDP! ` .
49
-
50
45
### RDP with Coder Desktop (Beta)
51
46
52
47
[ Coder Desktop] ( ../desktop/index.md ) 's Coder Connect feature creates a connection to your workspaces in the background.
@@ -57,7 +52,7 @@ Use your favorite RDP client to connect to `<workspace-name>.coder` instead of `
57
52
> [ !NOTE]
58
53
> Some versions of Windows, including Windows Server 2022, do not communicate correctly over UDP
59
54
> 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.
55
+ > When this happens, the RDP client will appear to connect, but displays a blank screen.
61
56
>
62
57
> To avoid this error, Coder's [ Windows RDP] ( https://registry.coder.com/modules/windows-rdp ) module
63
58
> [ disables RDP over UDP automatically] ( https://github.com/coder/registry/blob/b58bfebcf3bcdcde4f06a183f92eb3e01842d270/registry/coder/modules/windows-rdp/powershell-installation-script.tftpl#L22 ) .
@@ -83,7 +78,7 @@ For example:
83
78
coder://coder.example.com/v0/open/ws/myworkspace/agent/main/rdp?username=Administrator&password=coderRDP!
84
79
```
85
80
86
- To include a Coder Desktop button to the workspace dashboard page, add a ` coder_app ` resource to the template:
81
+ To include a Coder Desktop button on the workspace dashboard page, add a ` coder_app ` resource to the template:
87
82
88
83
``` tf
89
84
locals {
@@ -100,14 +95,19 @@ resource "coder_app" "rdp-coder-desktop" {
100
95
}
101
96
```
102
97
98
+ </div >
99
+
100
+ > [ !NOTE]
101
+ > The default username is ` Administrator ` and the password is ` coderRDP! ` .
102
+
103
103
## RDP Web
104
104
105
105
Our [ Windows RDP] ( https://registry.coder.com/modules/windows-rdp ) module in the Coder
106
106
Registry adds a one-click button to open an RDP session in the browser. This
107
107
requires just a few lines of Terraform in your template, see the documentation
108
108
on our registry for setup.
109
109
110
- ![ Web RDP Module in a Workspace] ( ../../images/user-guides/web-rdp-demo.png )
110
+ ![ Windows RDP Module in a Workspace] ( ../../images/user-guides/web-rdp-demo.png )
111
111
112
112
## Amazon DCV Windows
113
113
0 commit comments