# 🏠 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.50 (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 | | | ✅ |
| Immich | | | ✅ |
| Homarr | | | ✅ |
| Planka | | | ✅ |
| Vikunja | | | ✅ |
| Uptime Kuma | | | ✅ |
| 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`:

```markdown
# 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
```