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

<div class="note" id="bkmrk-%C3%9Cberblick%3A-diese-sei">**Ü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.

</div><div class="warn" id="bkmrk-wichtig%3A-kde-plasma-">**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.</div>---

<details id="bkmrk-anleitung-1-ausklapp"><summary>**Anleitung 1 ausklappen: KDE Plasma Wayland auf Debian 13 installieren**</summary>

## 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.

<div class="warn">**Voraussetzung:** Diese Anleitung geht davon aus, dass du als **root** arbeitest. Es wird kein `sudo` verwendet.</div>### 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 kwin-x11
```

<div class="note">**Hinweis:** In Debian 13/Trixie wird `plasma-workspace-wayland` nicht mehr separat verwendet. Die benötigten Wayland-Komponenten sind über `plasma-workspace` abgedeckt.</div><div class="note">**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.</div>### 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)
```

<div class="note">**Ergebnis:** Die lokale Anmeldung an der VM nutzt jetzt KDE Plasma mit Wayland.</div></details>---

<details id="bkmrk-anleitung-2-ausklapp"><summary>**Anleitung 2 ausklappen: Per XRDP und xfreerdp3 auf die VM zugreifen**</summary>

## 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.

<div class="warn">**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.</div>### 1. XRDP und Xorg-Backend installieren

Auf der VM als root ausführen:

```
apt update
apt install -y xrdp xorgxrdp dbus-x11
```

<div class="note">**Hinweis:** Wenn KDE Plasma bereits aus Anleitung 1 installiert wurde, müssen `plasma-desktop` und `plasma-workspace` hier nicht erneut installiert werden.</div>### 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

<div class="warn">**Sicherheit:** Melde dich nicht als root per RDP an. Verwende einen normalen Benutzer, zum Beispiel `jj`.</div>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

<div class="warn">**RDP nicht offen ins Internet stellen.** Port `3389` sollte nur im lokalen Netzwerk, über VPN oder über einen sicheren Tunnel erreichbar sein.</div>- 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.

</details>---

## Zusammenfassung

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