Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

RDP2Linux — Remote Desktop into Ubuntu from Windows

Access a full Ubuntu desktop from Windows over RDP — the clean, lab-tested way.

Ubuntu 22.04 | 24.04 | 26.04 Client: Windows 10 / 11 Protocol: RDP Desktop: GNOME / XFCE

The real Ubuntu GNOME desktop running over Remote Desktop from Windows

The genuine Ubuntu GNOME desktop — Files, the dock, a terminal, and Firefox — running live over RDP inside the Windows Remote Desktop client.

About

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

Why two methods?

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.

What's inside the guide

  • Prerequisites and how to reliably find the Ubuntu machine's IP
  • Method A — gnome-remote-desktop: install → TLS certificate → grdctl configuration → enable service → firewall → Windows client (NLA) → the two-stage login → verification
  • Method B — xrdp + XFCE: install → force the X11 backend → disable light-locker → connect
  • A symptom → cause → fix troubleshooting table
  • Switching between methods, security considerations, and a quick-reference cheat sheet

Validated on

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.

About

Lab-tested guide to Remote Desktop (RDP) from Windows into a full Ubuntu desktop - real GNOME via gnome-remote-desktop or lightweight XFCE via xrdp - with a complete troubleshooting reference and security notes.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors