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.
