Homelab_Doku/README.md

108 lines
2.3 KiB
Markdown

# 🏠 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 | 3000 | ✅ |
| Nextcloud | | | ✅ |
| Vaultwarden | pass.mbraune.com | | ✅ |
| Gotify | | | ✅ |
| IT-Tools | | | ✅ |
| Newt | — | — | ✅ |
| Beszel Agent | — | — | ✅ |
| Dockhand | — | — | ✅ |
---
## 🗄️ 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
```