From 3aecf55c8f979608162856432697d5526272acaa Mon Sep 17 00:00:00 2001
From: Remaxx <admin@mbraune.com>
Date: Wed, 5 Aug 2026 00:48:42 +0000
Subject: [PATCH] =?UTF-8?q?Dateien=20nach=20=E2=80=9E/=E2=80=9C=20hochlade?=
 =?UTF-8?q?n?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 108 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 108 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d9760eb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,108 @@
+# 🏠 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
+```