diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cadf2ea
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+============================================================
+      Debian-basierter RDP-Client mit Autologin & YAD
+============================================================
+
+Ziel:
+-----
+Ein minimalistisches Debian-System, das:
+- automatisch als rdpuser bootet
+- direkt X startet (ohne Desktop)
+- ein grafisches YAD-Login-Fenster zeigt
+- per xfreerdp zum Server 'satishc' verbindet
+- Hostnamen anhand MAC-Adresse setzt
+- für Acronis-Imaging geeignet ist
+
+------------------------------------------------------------
+Schritt 1: Benutzer anlegen
+------------------------------------------------------------
+adduser rdpuser
+apt install passwd
+usermod -aG sudo rdpuser
+
+------------------------------------------------------------
+Schritt 2: Setup-Skript ausführen
+------------------------------------------------------------
+
+------------------------------------------------------------
+
+Zertifikatswarnung bei xfreerdp:
+--------------------------------
+Lösung: /cert-ignore an xfreerdp anhängen
+
+Logging:
+--------
+Verbindungslog: ~/xfreerdp.log
+startx-Log (manuell): startx > ~/startx.log 2>&1
+
+Tuning (optional):
+------------------
+Zusätzliche Parameter für Performance:
+  /network:auto /gfx:AVC444 +async-channels /compression-level:2
+
+Fehlerbehebung:
+---------------
+- xterm fehlt → apt install xterm
+- startx geht nur als root → Xwrapper.config, Rechte prüfen
+- RDP friert ein → Login-Schleife automatisch zurücksetzen
+- .xinitrc fehlt oder ist leer → Inhalt prüfen, chmod +x setzen
+
+Bereit für Acronis:
+-------------------
+1. VM konfigurieren
+2. Image mit Acronis erstellen
+3. Ausrollen auf weitere Clients
+
+============================================================