diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000..db901ed Binary files /dev/null and b/.DS_Store differ diff --git a/README.md b/README.md index 90422dd..a777b13 100644 --- a/README.md +++ b/README.md @@ -5,4 +5,4 @@ Diese Dokumentation beschreibt Aufbau, Betrieb und bekannte Themen des Homelabs. ## Bereiche - [VPS-Dokumentation](VPS/README.md) - +- [Unraid-Dokumentation](Unraid/README.md) diff --git a/Unraid/README.md b/Unraid/README.md new file mode 100644 index 0000000..f4ffb2c --- /dev/null +++ b/Unraid/README.md @@ -0,0 +1,26 @@ +# Unraid-Dokumentation + +Diese Dokumentation beschreibt Aufbau, Dienste und Betrieb des Unraid-Servers. + +## Einstieg + +- [Übersicht](overview.md) +- [Dienste und Anwendungen](services.md) +- [Bekannte Themen und Verbesserungspotenzial](known-issues.md) + +## Infrastruktur + +- [Hardware](hardware.md) +- [Speicher, Array und Pools](storage.md) +- [Shares und Datenablage](shares.md) +- [Netzwerk](networking.md) +- [Docker](docker.md) +- [Virtuelle Maschinen](virtual-machines.md) +- [Sicherheit](security.md) + +## Betrieb + +- [Monitoring](monitoring.md) +- [Backup](backup.md) +- [Wartung und Betrieb](maintenance.md) + diff --git a/Unraid/backup.md b/Unraid/backup.md new file mode 100644 index 0000000..79b51be --- /dev/null +++ b/Unraid/backup.md @@ -0,0 +1,22 @@ +# Backup Dokumentation + +## Backup-Strategie + +Noch zu dokumentieren. + +## Gesicherte Daten + +Noch zu dokumentieren. + +## Backup-Ziele + +Noch zu dokumentieren. + +## Wiederherstellung + +Noch zu dokumentieren. + +## Restore-Tests + +Noch zu dokumentieren. + diff --git a/Unraid/docker.md b/Unraid/docker.md new file mode 100644 index 0000000..9ddce5c --- /dev/null +++ b/Unraid/docker.md @@ -0,0 +1,124 @@ +# Docker Dokumentation + +## Allgemein + +Der Unraid-Server nutzt Docker als zentrale Plattform für: + +- Infrastruktur-Dienste +- Medienserver +- Dokumentenmanagement +- Smart Home Komponenten +- interne Anwendungen + +--- + +## Netzwerkmodi + +Verwendete Modi: + +- bridge +- host +- br0 +- compose-basierte Netzwerke + +--- + +## Produktive Container + +| Dienst | Aufgabe | Status | +|---|---|---| +| AdGuard Home | DNS | aktiv | +| Immich | Fotoverwaltung | aktiv | +| MariaDB | Datenbank | aktiv | +| Netdata | Monitoring | aktiv | +| NPM | Reverse Proxy | aktiv | +| Paperless-ngx | Dokumentenmanagement | aktiv | +| PhotoPrism | Fotoverwaltung | aktiv | +| Plex | Medienserver | aktiv | +| Redis | Cache/Datenbank | aktiv | +| Scrypted | Kamera-Integration | aktiv | +| Seafile | Dateisynchronisation | gestoppt | +| Wiki.js | Dokumentation | aktiv | + +--- + +## Medienstack + +| Dienst | Aufgabe | +|---|---| +| Sonarr | Serienverwaltung | +| Radarr | Filmverwaltung | +| Lidarr | Musikverwaltung | +| Seerr | Request Management | +| SABnzbd | Downloads | + +--- + +## Compose Nutzung + +### Vorhandene Compose Stacks + +| Stack | Status | +|---|---| +| Immich | aktiv | + +Der Server nutzt bereits: + +- Compose Manager +- Compose-basierte Containerverwaltung + +Dies ermöglicht: + +- reproduzierbare Stacks +- bessere Versionskontrolle +- Infrastructure as Code + +--- + +## Netzwerkarchitektur + +### Auffälligkeiten + +Viele Dienste laufen aktuell: + +- im bridge Netzwerk +- mit direkten Portfreigaben + +Langfristig geplant: + +- interne Netzwerke +- zentrale Reverse-Proxy-Struktur +- weniger direkte LAN-Portfreigaben + +--- + +## Gestoppte Container + +| Container | Vermuteter Status | +|---|---| +| Seafile | Wartung/Migration | +| Recyclarr | ungenutzt | +| Whisparr | ungenutzt | +| Adminer | temporär | +| Firefly Importer | Altlast/Test | + +--- + +## Beobachtungen + +### Positiv + +- bereits relativ moderne Struktur +- Compose bereits im Einsatz +- klare Dienstetrennung +- wenige offensichtliche Docker-Probleme + +--- + +## Verbesserungspotenzial + +- interne Netzwerke vereinheitlichen +- Portfreigaben reduzieren +- Altlasten entfernen +- Compose Migration ausbauen +- zentrale Labels/Standards definieren diff --git a/Unraid/hardware.md b/Unraid/hardware.md new file mode 100644 index 0000000..8c70bd4 --- /dev/null +++ b/Unraid/hardware.md @@ -0,0 +1,14 @@ +# Hardware + +## System + +Noch zu dokumentieren. + +## Komponenten + +Noch zu dokumentieren. + +## Erweiterungen + +Noch zu dokumentieren. + diff --git a/Unraid/known-issues.md b/Unraid/known-issues.md new file mode 100644 index 0000000..3c50d46 --- /dev/null +++ b/Unraid/known-issues.md @@ -0,0 +1,22 @@ +# Bekannte Themen und Verbesserungspotenzial + +## Infrastruktur + +Noch zu dokumentieren. + +## Speicher + +Noch zu dokumentieren. + +## Dienste + +Noch zu dokumentieren. + +## Betrieb + +Noch zu dokumentieren. + +## Langfristige Themen + +Noch zu dokumentieren. + diff --git a/Unraid/maintenance.md b/Unraid/maintenance.md new file mode 100644 index 0000000..648e443 --- /dev/null +++ b/Unraid/maintenance.md @@ -0,0 +1,18 @@ +# Wartung und Betrieb + +## Regelmäßige Aufgaben + +Noch zu dokumentieren. + +## Updates + +Noch zu dokumentieren. + +## Paritätsprüfungen + +Noch zu dokumentieren. + +## Fehlerbehebung + +Noch zu dokumentieren. + diff --git a/Unraid/monitoring.md b/Unraid/monitoring.md new file mode 100644 index 0000000..25f9ec0 --- /dev/null +++ b/Unraid/monitoring.md @@ -0,0 +1,18 @@ +# Monitoring Dokumentation + +## Systemmonitoring + +Noch zu dokumentieren. + +## Speicherüberwachung + +Noch zu dokumentieren. + +## Dienstüberwachung + +Noch zu dokumentieren. + +## Alerting + +Noch zu dokumentieren. + diff --git a/Unraid/networking.md b/Unraid/networking.md new file mode 100644 index 0000000..b9fcf0d --- /dev/null +++ b/Unraid/networking.md @@ -0,0 +1,18 @@ +# Unraid Netzwerk + +## Netzwerkschnittstellen + +Noch zu dokumentieren. + +## VLANs und Bridges + +Noch zu dokumentieren. + +## DNS und Routing + +Noch zu dokumentieren. + +## VPN-Anbindung + +Noch zu dokumentieren. + diff --git a/Unraid/overview.md b/Unraid/overview.md new file mode 100644 index 0000000..85e3459 --- /dev/null +++ b/Unraid/overview.md @@ -0,0 +1,94 @@ +# Unraid Übersicht + +## Allgemeine Informationen + +| Eigenschaft | Wert | +|---|---| +| Hostname | mbyt3-server | +| Betriebssystem | Unraid 7.1.2 | +| IP-Adresse | 192.168.0.5 | +| Rolle | Zentraler Homeserver | +| Lizenz | Unraid Basic | + +--- + +## Aufgaben des Servers + +Der Unraid-Server dient als zentrale private Infrastruktur des Homelabs. + +Hauptaufgaben: + +- Dateispeicher +- Docker Hosting +- Medienserver +- Dokumentenmanagement +- Smart Home Infrastruktur +- Kamera-Integration +- Backup-Ziel +- interne Dienste +- private Cloud-Dienste + +--- + +## Architekturrolle + +Die Infrastruktur ist logisch getrennt: + +```text +Internet +↓ +VPS (Public Edge) +↓ WireGuard VPN +Unraid (Private Infrastruktur) +``` + +Der Unraid-Server hostet überwiegend: + +- interne Dienste +- private Daten +- Storage +- Medien +- Smart Home Komponenten + +--- + +## Hauptdienste + +| Bereich | Dienste | +|---|---| +| Medien | Plex, Immich | +| Dokumente | Paperless-ngx | +| Cloud | Seafile | +| Smart Home | Scrypted | +| Datenbanken | MariaDB, Redis | +| Verwaltung | Wiki.js | +| Netzwerk | AdGuard Home, NPM | +| Monitoring | Netdata | + +--- + +## Infrastrukturprinzipien + +### Aktuelle Architektur + +- VPS als öffentliche Edge +- Unraid als privater Kern +- Reverse Proxy Trennung +- VPN-basierte Kopplung +- Docker-basierte Dienste +- zentrale Datenhaltung + +--- + +## Zielbild + +Der Unraid-Server soll langfristig: + +- wartungsarm +- dokumentiert +- leicht wiederherstellbar +- energieeffizient +- zentralisiert +- sicher + +betrieben werden. diff --git a/Unraid/security.md b/Unraid/security.md new file mode 100644 index 0000000..347c7ed --- /dev/null +++ b/Unraid/security.md @@ -0,0 +1,18 @@ +# Sicherheitsdokumentation + +## Zugriffsmodell + +Noch zu dokumentieren. + +## Benutzer und Berechtigungen + +Noch zu dokumentieren. + +## Netzwerkzugriff + +Noch zu dokumentieren. + +## Sicherheitsmaßnahmen + +Noch zu dokumentieren. + diff --git a/Unraid/services.md b/Unraid/services.md new file mode 100644 index 0000000..0e8e286 --- /dev/null +++ b/Unraid/services.md @@ -0,0 +1,14 @@ +# Dienste und Anwendungen + +## Dienstübersicht + +Noch zu dokumentieren. + +## Abhängigkeiten + +Noch zu dokumentieren. + +## Kritikalität + +Noch zu dokumentieren. + diff --git a/Unraid/shares.md b/Unraid/shares.md new file mode 100644 index 0000000..4540729 --- /dev/null +++ b/Unraid/shares.md @@ -0,0 +1,18 @@ +# Shares und Datenablage + +## Share-Übersicht + +Noch zu dokumentieren. + +## Zugriffsrechte + +Noch zu dokumentieren. + +## Cache-Verhalten + +Noch zu dokumentieren. + +## Datenklassifizierung + +Noch zu dokumentieren. + diff --git a/Unraid/storage.md b/Unraid/storage.md new file mode 100644 index 0000000..0ca8d6e --- /dev/null +++ b/Unraid/storage.md @@ -0,0 +1,125 @@ +# Storage Dokumentation + +## Allgemeiner Aufbau + +Der Unraid-Server nutzt: + +- klassisches Unraid Array +- SSD Cache +- zentrale User Shares + +--- + +## Array + +### Aktueller Status + +| Eigenschaft | Wert | +|---|---| +| Gesamtgröße | ~16 TB | +| Belegt | ~9 TB | +| Parity | aktiv | +| Zustand | valid | + +--- + +## Cache + +### SSD Cache Pool + +| Eigenschaft | Wert | +|---|---| +| Größe | ~250 GB | +| Nutzung | ~48 GB | + +Der Cache dient für: + +- Appdata +- Docker Daten +- temporäre Daten +- schnelle Schreibvorgänge + +--- + +## Shares + +### Produktive Shares + +| Share | Zweck | +|---|---| +| appdata | Containerdaten | +| system | Docker/Systemdaten | +| domains | VM Daten | +| downloads | Medien-Downloads | +| nextcloud | Nextcloud Daten | +| paperless | Dokumentenarchiv | +| photos | Bilddaten | +| plex-media | Medienbibliothek | +| plex-transcode | Plex Transcoding | +| seafile | Seafile Daten | +| wiki | Wiki.js Daten | +| restore | Wiederherstellung | +| ha_backup | Home Assistant Backups | + +--- + +## Cache Nutzung + +### Shares mit Cache Nutzung + +| Share | Cache | +|---|---| +| appdata | Cache ↔ Array | +| system | Cache ↔ Array | +| plex-transcode | Cache ↔ Array | +| seafile | Cache ↔ Array | + +--- + +## Öffentliche SMB Shares + +| Share | Freigabe | +|---|---| +| Pictures | Public | +| plex-media | Public | +| timemachine | Public | + +--- + +## Benutzerbezogene Shares + +| Share | Zugriff | +|---|---| +| bilal | Private | +| julia | Private | + +--- + +## Beobachtungen + +### Positiv + +- klare Share-Struktur +- saubere Trennung der Daten +- sinnvoller SSD Cache Einsatz +- zentrale Datenhaltung + +--- + +## Verbesserungspotenzial + +### Noch offen + +- Share-Dokumentation ergänzen +- Backup-Relevanz je Share definieren +- Restore-Prioritäten festlegen +- Archivierungsstrategie dokumentieren + +--- + +## Langfristige Ziele + +- vollständige Backup-Strategie +- nachvollziehbare Datenstruktur +- automatisierte Wiederherstellung +- saubere Tiering-Strategie diff --git a/Unraid/virtual-machines.md b/Unraid/virtual-machines.md new file mode 100644 index 0000000..bc992b7 --- /dev/null +++ b/Unraid/virtual-machines.md @@ -0,0 +1,18 @@ +# Virtuelle Maschinen + +## VM-Übersicht + +Noch zu dokumentieren. + +## Ressourcen + +Noch zu dokumentieren. + +## Passthrough + +Noch zu dokumentieren. + +## Speicher und Backups + +Noch zu dokumentieren. +