diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d04b8b1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# Netmaker zu TunlGrid Migration
+
+Dieses Skript automatisiert den vollständigen Umzug eines bestehenden Netmaker-Nodes auf eine reine ("vanilla") WireGuard-Konfiguration (`wg0.conf`). Danach ist der Node bereit, über die TunlGrid-Agenten (`wg-sync.sh` / `node-sync.sh`) verwaltet zu werden.
+
+## 🚀 Features
+
+* Installiert fehlende Abhängigkeiten (`wireguard-tools`, `iptables`).
+* Exportiert die dynamische Netmaker-Konfiguration direkt aus dem Kernel.
+* Ermittelt und übernimmt die korrekte IP-Adresse des Interfaces.
+* Fügt NAT/Masquerading-Regeln (`PostUp`/`PostDown`) automatisch hinzu.
+* Bietet eine interaktive Sicherheits-Vorschau der generierten `wg0.conf` vor der Anwendung.
+* Stoppt und deaktiviert den Netmaker-Agenten (`netclient`) dauerhaft.
+
+## ⚡ Quickstart (One-Shot)
+
+Um die Migration zu starten, führe diesen Befehl auf dem Ziel-Node aus. Das Skript fragt vor den endgültigen Änderungen nach einer Bestätigung.
+
+```bash
+curl -sSL "[https://me-gitea.maieredv.cloud/manuel.maier/migrate-netmaker-to-tunlgrid/raw/branch/main/migrate.sh](https://me-gitea.maieredv.cloud/manuel.maier/migrate-netmaker-to-tunlgrid/raw/branch/main/migrate.sh)" | sudo bash
\ No newline at end of file