diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fb90c21
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# Nele & Till - Hochzeit Galerie
+
+Eine moderne, sichere und schnelle Bildergalerie für Hochzeitsbilder.
+
+## Deployment
+
+1. Sicherstellen, dass das Docker-Image (`git.orfel.de/jannik/nele-till-hochzeit:latest`) verfügbar ist.
+2. `.env` aus `.env.age` entschlüsseln: `./scripts/decrypt-env.sh` (oder `.ps1`)
+3. `docker compose -f docker-compose.prod.yml up -d` ausführen
+
+## Architektur
+- **Next.js 14** im Standalone-Modus (API + Frontend)
+- **PostgreSQL** für Metadaten, Layout und Likes
+- **Redis & BullMQ** für Hintergrund-Jobs (Bilder/Videos verarbeiten, ZIP erstellen)
+- **sharp & FFmpeg** für Medienkonvertierung direkt im Container
+
+## Administration
+Dashboard unter `/admin`. Erstes Passwort und Benutzer sind in der `.env` definiert.
+Dort kann der "Scanner" gestartet werden, um Bilder auf dem Volume neu einzulesen, und das "Layout" kann angepasst werden.