Homeserver (Intel NUC)¶

Intel NUC Homeserver im Heimnetzwerk (10.10.10.3). Betreibt rund 65 Container in 27 Compose-Stacks fuer Media, Monitoring, Smart Home, Produktivitaet und mehr.

Hardware: Intel NUC, lokale SSD (~134 GB), UNAS Pro NAS (91 TB RAID 6, NFS)
OS: Ubuntu / Docker CE + Docker Compose
Domain: *.home.robinwerner.net
Reverse Proxy: Traefik v3 (Let's Encrypt DNS-Challenge via Cloudflare)
Compose-Pfad: /opt/rpi-docker-compose/<stack>/
Repo: homeserver

Service-Kategorien¶

Kategorie	Services
Infrastruktur	Traefik, Cloudflare DDNS, Cloudflared, Pi-hole, Unbound, Tailscale, Portainer, NUT, Infisical Agent
Media	Jellyfin, Sonarr, Radarr, Prowlarr, SABnzbd, Gluetun, UmlautAdaptarr, Navidrome, Immich
Monitoring	Prometheus, VictoriaMetrics, VictoriaLogs, Grafana, Alloy, Alertmanager, ntfy-alertmanager, Exporter
Smart Home	Home Assistant, ESPHome, Zigbee2MQTT, Mosquitto, HA-MCP, Voice-Stack (Parakeet, Piper)
Produktivitaet	Paperless-NGX (+ Gotenberg, Tika), Syncthing, Ollama-Stack (+ Qdrant, Docling), Homepage, Wallos, VSCode, PKV-App, Bonus-Tracker
Backup	Borgmatic (lokal + Hetzner Storage Box)
Sonstiges	TeamSpeak 3, Project Zomboid, Snowflake

Zwei Stacks sind fachlich abgeloest

Der Ollama-Stack und der Voice-Stack laufen inzwischen auch auf dem AI-Server, der sie ersetzen soll. Beide sind hier noch produktiv; das Abschalten steht aus.

Schnelleinstieg¶

Voraussetzungen¶

Docker und Docker Compose
Externes Proxy-Netzwerk (einmalig erstellen):

docker network create proxy_network --driver bridge --subnet=10.100.0.0/16

Service starten¶

# Service-Stack starten
docker compose -f <service>/docker-compose.yaml up -d

# Logs anzeigen
docker compose -f <service>/docker-compose.yaml logs -f

# Service stoppen
docker compose -f <service>/docker-compose.yaml down

Compose-Template¶

Neue Services sollten diesem Muster folgen:

networks:
  proxy_network:
    external: true

services:
  example:
    container_name: example
    image: example/image:version
    restart: unless-stopped
    security_opt:
      - no-new-privileges:true
    networks:
      - proxy_network
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.example.rule=Host(`example.home.robinwerner.net`)"
      - "traefik.http.routers.example.entrypoints=websecure"
      - "traefik.http.routers.example.tls.certresolver=letsencrypt"
      - "traefik.http.services.example.loadbalancer.server.port=8080"

Architektur¶

Fuer die Gesamtarchitektur (Netzwerke, Storage, Abhaengigkeiten) siehe Architektur-Uebersicht.

Backups werden mit Borg/Borgmatic durchgefuehrt. Details auf der Backup-Seite.