diff --git a/README.md b/README.md
new file mode 100644
index 0000000..adbcc66
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+### 0. Temporäre Shell mit Git
+
+```bash
+nix-shell -p git
+```
+
+### 1. Repository klonen
+
+```bash
+git clone https://gitea.timvandenboom.eth64.de/nils/nixos ~/nixos
+cd ~/nixos
+
+```
+
+### 2. Symlink erstellen
+
+NixOS erwartet seine Konfiguration standardmäßig unter `/etc/nixos`. Wir verlinken unser lokales Verzeichnis dorthin:
+
+```bash
+sudo ln -s /home/nils/nixos /etc/nixos
+
+```
+
+### 3. Konfiguration anwenden
+
+Verwende für normale Änderungen `switch`. Wenn du jedoch **Kernel-Parameter** (wie für Hibernate) oder den **Bootloader** änderst, ist der `boot`-Befehl sicherer:
+
+```bash
+# Empfohlen nach Änderungen an der hibernation.nix oder boot.nix:
+sudo nixos-rebuild boot --flake .#nixos
+
+```