Skip to main content

Raspberry Pi · Heimnetzwerk

Online

Raspberry Pi 5 — Container Host

Docker Container Host

Der Container-Powerhouse im Homelab. Raspberry Pi 5 mit Portainer und 19 laufenden Docker Containern — von Dokumentenverwaltung über Projektplanung bis Workflow-Automatisierung.

12 services running

19 Container. Ein Pi. 8 Watt.

Alles läuft selbst gehostet — Dokumente, Tasks, Workflows, Infrastruktur.

Vom Router bis zum Browser: kein Cloud-Dienst nötig.

Feature deep dive

01

Portainer — Visuelle Container-Kontrolle

Alle 19 Container auf einen Blick. Logs einsehen, Stack deployen, Container neustarten — alles per Browser. Kein SSH nötig.

02

Traefik — Automatisches HTTPS

Jeder Container bekommt per Docker-Label eine Subdomain und ein Let's Encrypt Zertifikat. Null manuelle nginx-Konfiguration.

03

n8n — Workflow-Automatisierung

n8n verbindet alle Services: neues Dokument in Paperless löst iPhone-Benachrichtigung aus, GitHub-Commits erstellen Vikunja-Tasks.

Energieeffizienz

~5–8 W Idle

Der Pi 5 verbraucht unter Last kaum mehr als unter Idle. 19 Container, Gigabit-Netz, 24/7 — bei Stromkosten, die kaum messbar sind.

Reproduzierbarkeit

Alles in Docker Compose

Jeder Stack liegt als Compose-Datei vor. Neues Gerät, git clone, docker compose up — fertig. Kein undokumentierter Zustand.

Monitoring

Uptime Kuma

Alle Services werden überwacht. Push-Benachrichtigung auf iPhone wenn ein Container ausfällt oder langsam antwortet.

Outcomes

What I built

  • 19 Container laufen stabil auf einem einzigen Raspberry Pi 5
  • Portainer als zentrale Management-Oberfläche für alle Container
  • Paperless-ngx digitalisiert und archiviert alle Dokumente automatisch
  • Vikunja als self-hosted Projektmanagement- und To-do-Tool
  • n8n als Automatisierungs-Hub für Workflows zwischen Services
  • Traefik als Reverse Proxy mit automatischem TLS für alle Dienste
  • Uptime Kuma überwacht alle Services und sendet Benachrichtigungen
  • Watchtower aktualisiert Container-Images automatisch

Software

What runs on it

Dokumentenverwaltung
99.9%

Paperless-ngx

Jedes Dokument, das ins Haus kommt, wird gescannt, per OCR erkannt und indiziert. Einfach in einen Watch-Ordner auf der NAS legen — nach wenigen Minuten ist es durchsuchbar archiviert.

Port8000Uptime99.9%CategoryDokumentenverwaltung
Automatisierung
99.7%

n8n

Der Klebstoff zwischen allen Services. Automatisiert Routineaufgaben: Dokument-Alerts, Task-Erstellung aus GitHub-Commits, eigene Webhooks für alles andere.

Port5678Uptime99.7%CategoryAutomatisierung
Reverse Proxy
100%

Traefik

Jeder Container bekommt automatisch eine Subdomain und ein HTTPS-Zertifikat — nur durch zwei Docker-Labels. Kein manuelles nginx, kein Zertifikat-Management.

Port80/443Uptime100%CategoryReverse Proxy

Deep dive

Architecture & notes

Übersicht

Der Pi 5 ist das Workpferd des Homelabs. 19 Container, eine Maschine, ~8W Stromverbrauch. Das Verhältnis von Leistung zu Verbrauch ist kaum zu schlagen.

Container-Übersicht

ContainerZweckPort
Paperless-ngxDokumentenarchiv mit OCRintern
WordPressPersönliche Website/Blog80/443
VikunjaAufgaben & Projektmanagementintern
n8nWorkflow-Automatisierungintern
TraefikReverse Proxy + TLS80/443
Uptime KumaService-Monitoringintern
WatchtowerAutomatische Image-Updates
MariaDBDatenbank (WordPress, etc.)intern
PostgreSQLDatenbank (Paperless, n8n)intern
RedisCache (Paperless)intern
+ 9 weitereDiverse Services

Paperless-ngx

Paperless scannt, kategorisiert und macht alle Dokumente per Volltext durchsuchbar. Eingehende Dokumente werden in einen Watch-Ordner auf dem NAS gelegt und automatisch verarbeitet.

n8n Workflows

n8n verbindet die Services miteinander:

  • Neue Dokumente in Paperless → Benachrichtigung auf iPhone via Home Assistant
  • GitHub-Commits → Aufgabe in Vikunja erstellen
  • Eigene Webhooks für benutzerdefinierte Automationen

Traefik-Setup

# docker-compose.yml (Traefik)
traefik:
  image: traefik:v3
  command:
    - --certificatesresolvers.le.acme.email=mail@example.com
    - --certificatesresolvers.le.acme.storage=/acme.json
  labels:
    - traefik.enable=true

Jeder Container bekommt über Labels automatisch eine Subdomain und ein TLS-Zertifikat.

Config & Decisions

What I chose & why

What I chose

  • Raspberry Pi 5 statt x86-Miniserver für Energieeffizienz (~5-8W idle)
  • Portainer CE für einfache visuelle Container-Verwaltung
  • Traefik als Reverse Proxy — automatisches TLS via Let's Encrypt ohne Config-Aufwand
  • Docker Compose für alle Services — reproduzierbar und versionierbar
  • Watchtower für automatische Image-Updates — kein manuelles Pulling

Tradeoffs

  • ARM64-Architektur: manche Images nicht verfügbar oder weniger getestet als x86
  • 19 Container auf einem Pi teilen sich begrenzte RAM — 8 GB reichen, aber ohne viel Puffer
  • Kein ECC RAM — Datenverlust bei RAM-Fehler theoretisch möglich, Backups essenziell
  • Watchtower-Auto-Updates können selten Breaking Changes einbringen

What I'd change

  • Zweiten Pi 5 für HA-Setup mit Docker Swarm oder Portainer-Cluster
  • Secrets-Management mit Vault statt .env-Dateien
  • Monitoring-Stack (Prometheus + Grafana) für Container-Metriken
  • NVMe-HAT für schnelleres Storage statt SD/USB

Hardware

Specifications

Operating SystemRaspberry Pi OS Bookworm 64-bit
ProcessorRaspberry Pi 5 — Cortex-A76 4-core @ 2.4 GHz
Memory8 GB LPDDR4X
Storage256 GB+ SSD (via USB 3.0 oder NVMe HAT)
NetworkGigabit Ethernet
← Back to lineup