Skip to main content

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

```html

Debian 13: KDE Plasma Wayland installieren und per FreeRDP auf die VM zugreifen

Ü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. Das ist normal und kein Zeichen dafür, dass die Maschine beleidigt ist.

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 und Display-Manager installieren

apt install -y plasma-desktop plasma-workspace-wayland sddm dbus-x11
Hinweis: plasma-desktop installiert eine schlanke KDE-Plasma-Umgebung. Wer ein größeres KDE-Setup möchte, kann stattdessen später 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: 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-wayland 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.

Security-Basics

RDP nicht offen ins Internet stellen. Port 3389 sollte nur im lokalen Netzwerk, über VPN oder über einen sicheren Tunnel erreichbar sein. Das Internet ist kein vertrauenswürdiger Ort, eher eine schlecht beleuchtete Tiefgarage mit Bots.
  • 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.

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.

```

Back to top