🏠 Bastelhof Homelab Manager

Die zentrale Verwaltungsplattform für dein gesamtes Homelab

Modern · Modular · Dokumentiert · Zukunftssicher

🎞️ App-Rundgang

---

Version: v2.0.1 • Status: 🚧 Release Candidate • Plattform: Windows 10 / 11

---

📖 Projektbeschreibung

Der Bastelhof Homelab Manager ist eine moderne native Windows-Anwendung zur zentralen Verwaltung, Dokumentation und späteren Überwachung einer kompletten Homelab-Infrastruktur.

Ziel ist es, sämtliche Systeme, Dienste und Netzwerkkomponenten in einer einzigen Anwendung zusammenzuführen. Statt zwischen verschiedenen Weboberflächen zu wechseln, bietet der Bastelhof Homelab Manager ein zentrales Dashboard für Administration, Dokumentation und zukünftige Automatisierung.

Die Anwendung wird vollständig in C#, .NET und WinUI 3 entwickelt und folgt einer modularen MVVM-Architektur. Alle Daten werden lokal gespeichert und können später über verschiedene API-Connectoren mit bestehenden Systemen synchronisiert werden.

---

✨ Kernfunktionen

Modul	Beschreibung
🏠 Dashboard	Zentrale Übersicht über Infrastruktur und Dienste
🌐 Netzwerk	Verwaltung von IPv4-, IPv6- und Netzwerkprofilen
🖥️ Geräte	Inventarisierung aller Netzwerkgeräte
🔎 Netzwerk-Scan	Ping-, DNS-, ARP- und Inventarabgleich
📦 Proxmox	Nodes und Gäste lesen und bestätigt steuern
🐳 Docker	Portainer-Umgebungen, Stacks und Container lesen
🌍 Dienste	Verwaltung aller lokalen Dienste
🌐 DNS	AdGuard Home und DNS-Dokumentation
🔀 Reverse Proxy	Nginx Proxy Manager
💾 Backups	Backupjobs, Laufstatus und Restore-Hinweise
📊 Monitoring	Zustands-, Speicher- und Zertifikatswarnungen
🧩 Plugins	Hash-vertraute, explizit aktivierte Erweiterungen
⚙️ Automation	Protokollierte Intervall- und Agentstatusregeln
🤖 Agents	Sicherer read-only Status von Linux-Systemen
📦 Installer	Deutsche Setup-EXE mit frei wählbarem Zielpfad
💼 Portable	Lokale Datenhaltung direkt im verschiebbaren Ordner
🌐 Distribution	Ausschließlich deutsche und englische Ressourcen
📚 Dokumentation	Automatische Erstellung technischer Dokumentationen

---

🖼️ Oberfläche

Der App-Rundgang zeigt den aktuellen Stand von Version 2.0.1 einschließlich Backup Center, Monitoring, Plugins & Automatisierung sowie der Bastelhof-WinUI3-Farbsprache.

Die Hauptbereiche verwenden ein konsistentes Bastelhof-Farblayout im Stil der anderen Bastelhof-WinUI3-Apps: tiefe Navy-Flächen, dezente blaue Panels, hellblaue Tabellenköpfe, klare Abschnittstitel und gerahmte Detailkarten. Listen wie Proxmox-Gäste, Docker-Container, DNS-Rewrites, Geräte, Dienste, Backups, Monitoring, Plugins, Automatisierungen und Agents besitzen sichtbare Spaltenüberschriften, damit Werte nicht ohne fachliche Überkategorie erscheinen.

---

🛠️ Technologie-Stack

Bereich	Technologie
Sprache	C#
Framework	.NET 8+
UI	WinUI 3
Alternative UI	WPF
Architektur	MVVM
Datenbank	SQLite
Dependency Injection	Microsoft DI
Logging	Microsoft.Extensions.Logging
Dokumentation	Markdown
Versionsverwaltung	Git

---

🗺️ Entwicklungs-Roadmap

Version	Status	Schwerpunkt
✅ v1.0.0	Abgeschlossen	Grundsystem
✅ v1.1.0	Abgeschlossen	Proxmox
✅ v1.2.0	Abgeschlossen	Docker & Portainer
✅ v1.3.0	Abgeschlossen	AdGuard Home
✅ v1.4.0	Abgeschlossen	Nginx Proxy Manager
✅ v1.5.0	Abgeschlossen	Netzwerk-Scan
✅ v1.6.0	Abgeschlossen	Backup Center
✅ v1.7.0	Abgeschlossen	Monitoring
✅ v1.8.0	Abgeschlossen	Inno-Setup-Installer
✅ v1.9.0	Abgeschlossen	Portable-Modus
🚧 v2.0.1	Release Candidate	UI-Konsistenz, Plugins, Automation, Agents und DE/EN
🚀 v3.0.0	Vision	Bastelhof Infrastructure Suite

---

📂 Repository-Struktur

Bastelhof_HomeLab_Manager/
│
├── docs/
│   ├── api/
│   ├── architecture/
│   ├── database/
│   ├── deployment/
│   ├── development/
│   ├── images/
│   ├── modules/
│   ├── network/
│   ├── security/
│   └── ui/
│
├── src/
├── installer/
├── build/
├── scripts/
├── wiki/                 # separates Forgejo-Wiki-Repository
│
├── AGENTS.md
├── DECISIONS.md
├── MASTERPROMPT.md
├── ROADMAP.md
├── REQUIREMENTS.md
├── DATABASE.md
├── API.md
├── README.md
└── CHANGELOG.md

---

🚀 Build

Projekt wiederherstellen

dotnet restore

Projekt kompilieren

dotnet build

Versionierten Release-Build erzeugen:

.\scripts\build.ps1 -Version 2.0.1 -Runtime win-x64

Der Ordner build/ enthält ausschließlich lokal erzeugte Artefakte, ist über .gitignore ausgeschlossen und wird nicht in das Git-Repository hochgeladen.

---

Wiki

Die ausführliche Benutzer-, Administrator- und Entwicklerdokumentation liegt im separaten Forgejo-Wiki:

ssh://git@git.bastelhof.srv64.de/Bastelhof/Bastelhof_HomeLab_Manager.wiki.git

Alle Wiki-Seiten liegen als einzelne Markdown-Dateien direkt im Root des Wiki-Repositories. Home.md dient als zentrale Navigation; interne Links verwenden die Forgejo-Syntax wie [[Netzwerk]] oder [[Architektur]].

Lokale Wiki-Kopie anlegen:

git clone ssh://git@git.bastelhof.srv64.de/Bastelhof/Bastelhof_HomeLab_Manager.wiki.git wiki

---

🌿 Git

Repository klonen

git clone ssh://git@git.bastelhof.srv64.de/Bastelhof/Bastelhof_HomeLab_Manager.git

Änderungen übernehmen

git add .
git commit -m "Beschreibung der Änderung"
git push

---

📦 Build-Ausgabe

build/
└── bastelhof_homelab_manager/
    └── <Version>/
        ├── app/
        ├── agent/
        ├── installer/
        ├── portable/
        ├── docs/
        ├── checksums/
        └── changelog.md

Akzeptanztest des veröffentlichten Builds:

.\scripts\verify-release.ps1 -Version 2.0.1 -Runtime win-x64
.\scripts\acceptance-test.ps1 -Version 2.0.1 -Runtime win-x64

Das Bastelhof-Markenbild liegt als Master-PNG sowie als optimierte Windows- und Dashboard-Varianten unter src/Bastelhof.HomelabManager.App/Assets/.

Die Setup-EXE liegt anschließend unter installer/, die verschiebbare Ausgabe unter portable/ und der selbstenthaltende Linux-x64-Agent unter agent/linux-x64/. Alle erzeugten Payloads enthalten höchstens deutsche und englische Laufzeitressourcen. Die Abnahme von Version 2.0.1 wird unter docs/deployment/release-2.0.1.md dokumentiert. Die Live-Tests von 1.6.0, 1.9.0 und der Sprachoptimierung wurden am 4. Juli 2026 bestanden; die neuen 2.0.x-Funktionen und die UI-Politur benötigen noch ihre Live-Abnahme.

---

📊 Projektstatus

Kategorie	Status
Entwicklung	🟢 Aktiv
Repository	🟢 Privater Git-Server
Plattform	Windows 10 / 11
Architektur	MVVM
Sprache	Deutsch
Lizenz	Proprietär

---

🔒 Lizenz

Der Bastelhof Homelab Manager ist ein proprietäres Softwareprojekt.

Die Entwicklung erfolgt ausschließlich für die interne Nutzung innerhalb des Bastelhof-Projekts. Eine Veröffentlichung oder Weitergabe außerhalb des Projekts ist ohne ausdrückliche Genehmigung des Projektinhabers nicht gestattet.

---

❤️ Entwickelt für das Bastelhof Homelab

Eine Anwendung. Ein Dashboard. Das gesamte Homelab.