new readme

README.md

@@ -1 +1,34 @@
-blabla
+# 🏡 Homelab Infrastructure
+
+Welkom bij de centrale repository voor mijn Homelab infrastructuur. Deze repo bevat alle Docker Compose configuraties, scripts en templates om de omgeving te beheren volgens het **Infrastructure as Code (IaC)** principe.
+
+## 🏗 Architectuur
+
+* **Host OS:** Debian 12 (Bookworm) op Proxmox.
+* **Container Engine:** Docker & Docker Compose.
+* **Secrets Management:** 1Password (via `.env` injection & CLI).
+* **Git Hosting:** Self-hosted Forgejo (met push-mirror naar GitHub).
+* **Netwerk:** Netbird (Mesh VPN) & Traefik (Reverse Proxy).
+* **Identity:** Authentik (SSO & Security).
+
+## 📂 Mappenstructuur
+
+De repository is logisch ingedeeld om deployment en onderhoud te versimpelen:
+
+```text
+.
+├── 1. Docker-Stacks/          # De actieve services
+│   ├── authentik/             # Identity Provider
+│   ├── forgejo/               # Git Service
+│   ├── netbird/               # VPN Client
+│   ├── semaphore/             # CI/CD & Automation
+│   └── traefik/               # Reverse Proxy
+│
+├── 2. Scripts/                # Beheer & Backup scripts
+│   ├── update-all.sh          # Script om hele stack te updaten vanuit Git
+│   └── backup-forgejo.sh      # Backup script voor Forgejo naar NAS
+│
+├── 3. Templates/              # Voorbeelden voor configuratie
+│   └── 1password.env.example  # Template voor 1Password referenties
+│
+└── README.md                  # Dit bestand