Admin Überblick

Diese Sektion dokumentiert die technische Infrastruktur, Einrichtung und Administration unseres Familienservers. Hier findest du alle Informationen für die Verwaltung, Wartung und Konfiguration des Systems.

Tech Stack

• Hardware: Beelink S12 Mini-PC
• Betriebssystem: Linux mit Debian 13 (Trixie)
• Netzwerk: Tailscale
• Shell: Fish
• Virtualisierung: Docker
• Backups: Restic (Backup Software) + Rclone (Cloud Schnittstelle) + Storj (Cloud Provider)
• Speicher: WD RED HDD 4TB (primär) + 1 TB HDD (lokaler Mirror)
• Monitoring: Uptime Kuma
• Reverse Proxy: Caddy
• DNS: Cloudflare
• Öffentlicher Zugang: Cloudflare Tunnel (cloudflared)
• Server Konfiguration: Ansible
• Abhängigkeiten: Renovate
• Dateifreigabe: Samba
• Anwendungen:
  • Immich (Fotos)
  • Immich Frame (Fotos Slideshow)
  • Immich Public Proxy (öffentliche Immich-Freigabelinks)
  • Immich Event-Instanz (Gäste-Uploads über Freigabelinks)
  • Jellyfin (Filme, Serien, Musik)
  • Gitea (Code Hosting)
  • Gitea Mirror (Git Repository Mirror Tool)
  • Mealie (Rezepte)
  • Uptime Kuma (Statusseite)
  • qBittorrent hinter Gluetun

Netzwerkzugänge

Es gibt drei Wege auf die Dienste, mit klar getrennten Aufgaben:

Weg	Reichweite	Wofür
Tailscale + MagicDNS	nur Familiengeräte im Tailnet	Standardweg über beelink:<port>
Caddy auf Subdomain	nur im Tailnet	schöne URLs mit gültigem TLS
Cloudflare Tunnel	offenes Internet	bewusst veröffentlichte Endpunkte

Schnellstart

Um mit der Administration des Servers zu beginnen:

1. Zugriff einrichten: Stelle sicher, dass Tailscale auf dem Server installiert ist und du SSH-Zugriff hast
2. Repository klonen: Klone das GitHub Repository für Zugriff auf Ansible Playbooks
3. Server konfigurieren: Führe die Server Einrichtung durch oder aktualisiere bestehende Konfigurationen

Wartung

Täglich (automatisiert):

• Backups werden automatisch täglich ausgeführt

Monatlich:

• Speicherplatz prüfen (df -h)
• Backup-Integrität testen
• Docker Clean up (mise run cleanup-docker)
• Anwendungen auf neueste Versionen aktualisieren (Renovate Bot)
• System Update (mise run update-system)

Reboot

Nach mise run update-system siehst du, ob ein Reboot erforderlich ist.

Falls nötig, starte den Server mit:

sudo reboot

Die Downtime beträgt in der Regel etwa 2 Minuten. Es sind keine zusätzlichen Schritte vor oder nach dem Reboot erforderlich.