Access a full Ubuntu desktop from Windows over RDP β the clean, lab-tested way.
The genuine Ubuntu GNOME desktop β Files, the dock, a terminal, and Firefox β running live over RDP inside the Windows Remote Desktop client.
RDP2Linux is a concise, lab-tested reference for reaching a full Ubuntu
desktop from a Windows PC using the built-in Remote Desktop Connection
(mstsc.exe) client. It distills a complete, real-world setup β including the
subtle Wayland/X11 and authentication pitfalls that derail most tutorials β into a
clean, repeatable procedure that takes you from a headless Ubuntu machine to a
working graphical session in minutes.
It documents two practical, tested methods and every failure mode discovered along the way, with clean step-by-step instructions, a troubleshooting reference, and security notes.
| Method | Desktop | Use when |
|---|---|---|
gnome-remote-desktop (recommended) |
The real Ubuntu GNOME desktop (Wayland-native RDP) | You want the native GNOME desktop β the practical choice where GNOME is Wayland-only (25.04+) |
xrdp + XFCE |
A lightweight XFCE desktop | You want a fast, low-resource session on any Ubuntu version |
π Read the full guide: instructions.md
Modern Ubuntu GNOME runs only on Wayland β on Ubuntu 25.04/26.04 the Xorg
GNOME session has been removed, and GNOME Shell refuses to start under X11.
Because xrdp serves an X11 display (via xorgxrdp), it cannot host the
Wayland-only GNOME Shell on those releases. Use gnome-remote-desktop (GNOME's
own Wayland-native RDP server) for the full GNOME desktop, or xrdp for a
lightweight XFCE (or other X11) desktop.
Note: system Remote Login (
grdctl --system) requires GNOME 46+ (Ubuntu 24.04+) and does not exist on Ubuntu 22.04. The commands in the guide were validated on Ubuntu 26.04; behaviour varies by GNOME version.
- Prerequisites and how to reliably find the Ubuntu machine's IP
- Method A β
gnome-remote-desktop: install β TLS certificate βgrdctlconfiguration β enable service β firewall β Windows client (NLA) β the two-stage login β verification - Method B β
xrdp+ XFCE: install β force the X11 backend β disablelight-lockerβ connect - A symptom β cause β fix troubleshooting table
- Switching between methods, security considerations, and a quick-reference cheat sheet
Ubuntu 26.04 LTS (GNOME 50, gnome-remote-desktop 50.0) connecting from
Windows 11. The GNOME-vs-xrdp distinction also applies to Ubuntu 22.04 / 24.04,
but the exact Method A commands and behaviour vary by GNOME version.
