Castro‘s Tech Blog

Homelab-Überwachung leicht gemacht: Der ultimative Guide zu Uptime Kuma

8. Juli 2026

Ein Homelab ist ein lebendes System. Dienste können abstürzen, Server offline gehen oder Netzwerke Probleme machen. Die wichtigste Frage ist: Woher weißt du, dass etwas nicht stimmt, bevor es zu einem echten Problem wird? Die Antwort ist proaktives Monitoring. Und das beste Tool dafür ist Uptime Kuma.

Warum Uptime Kuma?

Uptime Kuma ist ein Open-Source-Monitoring-Tool, das extrem einfach einzurichten ist, eine wunderschöne Benutzeroberfläche hat und dennoch unglaublich mächtig ist. Es ist die perfekte Lösung für jedes Homelab.

Installation mit Docker Compose

Wie bei den meisten modernen Diensten ist die Installation mit Docker ein Kinderspiel.

1. Erstelle ein Verzeichnis und eine docker-compose.yml Datei:

mkdir -p /pfad/zu/deinem/uptime-kuma
cd /pfad/zu/deinem/uptime-kuma

2. Füge folgenden Inhalt in die docker-compose.yml ein:

version: '3.8'

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "3001:3001" # Host-Port:Container-Port

3. Starte den Container:

docker compose up -d

Nach wenigen Sekunden ist Uptime Kuma unter http://DEINE_SERVER_IP:3001 erreichbar.

Sinnvolle Monitore einrichten

Nachdem du einen Admin-Account erstellt hast, kannst du deine ersten Monitore hinzufügen. Hier sind einige Must-haves für jedes Homelab:

  • HTTP(s)-Check für Webdienste: Überwache deine wichtigsten Web-Anwendungen (Nextcloud, Ghost-Blog etc.). Uptime Kuma prüft, ob die Seite erreichbar ist und einen korrekten Statuscode (z.B. 200) zurückgibt.
  • Ping-Check für Server & Geräte: Überwache die grundlegende Erreichbarkeit deiner Server, deines NAS oder deines Routers. Wenn ein Gerät nicht auf einen Ping antwortet, ist es offline.
  • Docker Container-Check: Wenn du Uptime Kuma auf demselben Host wie deine anderen Docker-Dienste betreibst, kannst du den Docker-Socket durchreichen und direkt überwachen, ob deine Container laufen.
  • DNS-Check: Überprüfe, ob deine Domain korrekt auf die richtige IP-Adresse auflöst. Nützlich, um Probleme mit DynDNS oder deinem Domain-Anbieter zu erkennen.

Benachrichtigungen: Wissen, wenn etwas passiert

Ein Monitor ist nur nützlich, wenn du von einem Ausfall erfährst. Uptime Kuma unterstützt über 90 Benachrichtigungsdienste. Richte einen Kanal ein, den du wirklich nutzt, z.B. Telegram, Discord oder E-Mail. Unter "Settings" > "Notifications" kannst du deinen gewünschten Dienst hinzufügen und ihn dann deinen Monitoren zuweisen.

Fazit

Uptime Kuma ist ein unverzichtbares Werkzeug für jeden Homelab-Betreiber. Es gibt dir die Sicherheit zu wissen, dass deine Dienste laufen, und informiert dich sofort, wenn sie es nicht tun. Der geringe Einrichtungsaufwand macht es zu einem der ersten Dienste, die du in deinem Homelab installieren solltest.

Dennis