Skip to content

jeevanbisht/RDP2Linux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 

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

Watchers

Forks

Releases

Packages

Contributors