homelab_docker/README.md

🏠 Homelab Docker Stack

Übersicht aller selbst gehosteten Services, aufgeteilt nach Host. Secrets werden nicht hier gespeichert → Vaultwarden (pass.mbraune.com).

---

📡 Infrastruktur

Komponente	Detail
Externe Domain	mbraune.com
Tunnel	Pangolin / Newt (Zero-Trust)
Internes Netz	192.168.178.x (Proxmox-LXC-Stack)
Docker-Netzwerk	proxy_net (extern erreichbar via Newt)
Compose-Dateiname	immer compose.yaml

---

🖥️ Proxmox LXC (192.168.178.50)

Service	URL	Port intern	Status
Forgejo	git.mbraune.com	—	✅
Nextcloud	cloud.mbraune.com	—
Vaultwarden	pass.mbraune.com	—	✅
Gotify	gotify.mbraune.com	—	✅
IT-Tools	—	—	✅
Newt	—	—	✅
Beszel Agent	—	—	✅
Dockhand	dockhand.mbraune.com	—	✅

---

🗄️ Synology NAS

Service	URL	Port intern	Status
Jellyfin			✅
Homarr			Umziehen
Planka			Umziehen
Vikunja			✅
Uptime Kuma			Umziehen
Stirling PDF			✅
Beszel			✅
Portracker			✅

---

📁 Repo-Struktur

homelab-docker/
├── proxmox/
│   ├── forgejo/
│   │   ├── compose.yaml
│   │   ├── .env.example
│   │   └── README.md
│   ├── nextcloud/
│   │   ├── compose.yaml
│   │   ├── .env.example
│   │   └── README.md
│   └── vaultwarden/
│       ├── compose.yaml
│       ├── .env.example
│       └── README.md
├── nas/
│   ├── jellyfin/
│   │   ├── compose.yaml
│   │   └── README.md
│   └── ...
└── README.md

---

🔐 Secrets-Verwaltung

• Echte .env-Dateien (mit Passwörtern) → Vaultwarden Secure Note pro Service
• In diesem Repo nur .env.example mit leeren Werten committen
• Niemals echte Secrets committen

---

📝 Service README-Vorlage

Jeder Service-Ordner hat eine eigene README.md:

# Service Name

## Info
- **URL:** https://subdomain.mbraune.com
- **Host:** Proxmox LXC / Synology NAS
- **Interner Port:** 3000

## Abhängigkeiten
- proxy_net (Pangolin/Newt)
- PostgreSQL (forgejo-db)

## Besonderheiten
- Registrierung deaktiviert (DISABLE_REGISTRATION=true)
- ...

## Letzte Änderungen
- 2026-08-05: Initiales Setup