Skip to main content

Debian 13 + XRDP + KDE Plasma (X11) – Basic Setup

Überblick: Diese Seite besteht aus zwei getrennten Anleitungen:
  1. KDE Plasma mit Wayland für die lokale Anmeldung auf der VM installieren.
  2. XRDP einrichten und sich anschließend per xfreerdp3 mit der VM verbinden.
Wichtig: KDE Plasma Wayland und XRDP sind zwei verschiedene Dinge. Die lokale KDE-Sitzung kann Wayland nutzen. Eine XRDP-Sitzung mit KDE läuft dagegen zuverlässig als X11, nicht als Wayland.

Anleitung 1 ausklappen: KDE Plasma Wayland auf Debian 13 installieren

Anleitung 1: KDE Plasma Wayland auf Debian 13 installieren

Diese Anleitung installiert KDE Plasma mit Wayland-Unterstützung für die lokale Anmeldung an der VM.

Voraussetzung: Diese Anleitung geht davon aus, dass du als root arbeitest. Es wird kein sudo verwendet.

1. Paketquellen aktualisieren

apt update

2. KDE Plasma mit Wayland-Unterstützung und Display-Manager installieren

apt install -y plasma-desktop plasma-workspace sddm dbus-x11
Hinweis: In Debian 13/Trixie wird plasma-workspace-wayland nicht mehr separat verwendet. Die benötigten Wayland-Komponenten sind über plasma-workspace abgedeckt.
Schlanke Installation: plasma-desktop installiert eine relativ schlanke KDE-Plasma-Umgebung. Wer später ein größeres KDE-Setup möchte, kann zusätzlich kde-standard oder kde-full installieren.

3. SDDM aktivieren

SDDM ist der Login-Manager für die grafische Anmeldung.

systemctl enable sddm

4. Grafischen Startmodus aktivieren

systemctl set-default graphical.target

5. System neu starten

reboot

6. Bei KDE Plasma Wayland anmelden

Nach dem Neustart erscheint der grafische Login-Bildschirm.

Wähle dort vor dem Login als Sitzung:

Plasma (Wayland)
Ergebnis: Die lokale Anmeldung an der VM nutzt jetzt KDE Plasma mit Wayland.

Anleitung 2 ausklappen: Per XRDP und xfreerdp3 auf die VM zugreifen

Anleitung 2: Per XRDP und xfreerdp3 auf die VM zugreifen

Diese Anleitung richtet XRDP auf der VM ein und zeigt danach die Verbindung mit xfreerdp3 vom Client aus.

Wichtig: Die XRDP-Sitzung startet KDE Plasma als X11-Session. Wayland wird für XRDP hier bewusst nicht verwendet, weil KDE über XRDP als X11-Sitzung deutlich zuverlässiger läuft.

1. XRDP und Xorg-Backend installieren

Auf der VM als root ausführen:

apt update
apt install -y xrdp xorgxrdp dbus-x11
Hinweis: Wenn KDE Plasma bereits aus Anleitung 1 installiert wurde, müssen plasma-desktop und plasma-workspace hier nicht erneut installiert werden.

2. XRDP-Startscript für KDE Plasma X11 setzen

Bearbeite die Datei:

/etc/xrdp/startwm.sh

Ersetze den kompletten Inhalt durch:

#!/bin/sh

unset DBUS_SESSION_BUS_ADDRESS
unset XDG_RUNTIME_DIR

export XDG_SESSION_TYPE=x11
export KDE_FULL_SESSION=true
export QT_QPA_PLATFORM=xcb

export QT_QUICK_BACKEND=software
export LIBGL_ALWAYS_SOFTWARE=1

export KWIN_COMPOSE=N
export KWIN_NO_COMPOSITING=1

exec dbus-run-session -- startplasma-x11

3. Startscript ausführbar machen

chmod +x /etc/xrdp/startwm.sh

4. XRDP-Dienste aktivieren und starten

systemctl enable --now xrdp xrdp-sesman

5. IP-Adresse der VM anzeigen

Auf der VM ausführen:

hostname -I

Merke dir die passende IP-Adresse der VM. Diese wird später bei xfreerdp3 als SERVER-IP verwendet.

6. Benutzer für die RDP-Anmeldung verwenden

Sicherheit: Melde dich nicht als root per RDP an. Verwende einen normalen Benutzer, zum Beispiel jj.

Falls noch kein normaler Benutzer vorhanden ist, kann einer angelegt werden:

adduser jj

7. FreeRDP-Client installieren

Auf dem Linux-Client ausführen, von dem aus du dich zur VM verbinden möchtest:

apt update
apt install -y freerdp3-x11

8. Verbindung zur VM herstellen

Auf dem Client ausführen:

xfreerdp3 /v:SERVER-IP:3389 /u:jj /d:. /dynamic-resolution /clipboard /cert:tofu

Beispiel:

xfreerdp3 /v:192.168.178.50:3389 /u:jj /d:. /dynamic-resolution /clipboard /cert:tofu

9. Bedeutung der wichtigsten Optionen

  • /v:SERVER-IP:3389 verbindet sich mit der VM auf Port 3389.
  • /u:jj verwendet den Benutzer jj.
  • /d:. bedeutet: keine Domain verwenden.
  • /dynamic-resolution passt die Auflösung beim Vergrößern oder Verkleinern des Fensters an.
  • /clipboard aktiviert Copy/Paste zwischen Client und RDP-Sitzung.
  • /cert:tofu merkt sich das Zertifikat beim ersten Verbindungsaufbau.

10. Security-Basics

RDP nicht offen ins Internet stellen. Port 3389 sollte nur im lokalen Netzwerk, über VPN oder über einen sicheren Tunnel erreichbar sein.
  • Kein Root-Login per RDP.
  • Starke Passwörter verwenden.
  • Port 3389 nicht öffentlich ins Internet freigeben.
  • Wenn möglich nur Zugriff aus dem internen Netz erlauben.
  • System regelmäßig aktualisieren.

11. Typische Stolpersteine

XRDP zeigt keinen KDE-Desktop

Prüfe, ob die Dienste laufen:

systemctl status xrdp
systemctl status xrdp-sesman

Keine Fensterleisten oder Fenster lassen sich nicht verschieben

Dann läuft KWin wahrscheinlich nicht sauber oder Compositing stört die XRDP-Sitzung.

Das Startscript aus dieser Anleitung deaktiviert Compositing bereits für die XRDP-Sitzung:

export KWIN_COMPOSE=N
export KWIN_NO_COMPOSITING=1

Danach XRDP neu starten:

systemctl restart xrdp xrdp-sesman

Panel ist schwarz oder Transparenzen sehen kaputt aus

Das kann durch deaktiviertes Compositing passieren. Für XRDP ist das meist der stabilere Weg.

Mögliche Lösung:

  • Panel auf undurchsichtig stellen.
  • Ein Theme ohne starke Transparenzen verwenden.
  • XRDP-Sitzung weiterhin als X11 laufen lassen.

Zusammenfassung

  • Lokale Anmeldung: KDE Plasma Wayland über SDDM.
  • Remote-Zugriff per XRDP: KDE Plasma X11 über startplasma-x11.
  • Client: Verbindung mit xfreerdp3.