Uptime Kuma einrichten 2026: Monitoring für Homeserver und Dienste

Uptime Kuma ist das selbstgehostete Monitoring-Dashboard, das dir sagt, wenn ein Dienst ausfällt – und zwar bevor die Familie fragt, warum „das Internet kaputt“ ist. Wer einmal erlebt hat, wie die Nextcloud drei Tage unbemerkt offline war, weil ein Container nach einem Update nicht mehr hochkam, weiß: Ein Homelab ohne Monitoring ist ein Blindflug. In diesem Artikel zeige ich dir, wie du Uptime Kuma per Docker installierst, deine ersten Monitore anlegst, Benachrichtigungen über Telegram einrichtest und eine Status-Seite baust, die auch Nicht-Techniker verstehen. Und wir reden ehrlich über das Henne-Ei-Problem: Wer überwacht eigentlich den Wächter?

Was Uptime Kuma kann

Uptime Kuma ist ein Open-Source-Projekt von Louis Lam und hat sich in den letzten Jahren zum De-facto-Standard für Verfügbarkeits-Monitoring im Homelab entwickelt. Die Oberfläche ist so hübsch und aufgeräumt, dass man fast vergisst, dass hier ein ernsthaftes Werkzeug dahintersteckt. Die wichtigsten Monitor-Typen im Überblick:

• HTTP(S): Prüft, ob eine Webseite oder ein Webdienst antwortet – inklusive Statuscode-Auswertung.
• Keyword-Check: Prüft zusätzlich, ob ein bestimmter Text auf der Seite steht. Praktisch, wenn ein Dienst zwar HTTP 200 liefert, aber nur eine Fehlerseite anzeigt.
• Ping: Klassisches ICMP – ist das Gerät überhaupt erreichbar?
• TCP-Port: Antwortet ein bestimmter Port? Ideal für Dienste ohne Weboberfläche, etwa SMB auf dem NAS oder eine Datenbank.
• DNS: Löst ein DNS-Server Anfragen korrekt auf?
• Docker-Container: Läuft ein bestimmter Container noch?

Dazu kommen Benachrichtigungen über mehr als 90 Kanäle – Telegram, E-Mail, Ntfy, Discord, Signal, Pushover und viele mehr –, öffentliche Status-Seiten und eine Warnung, bevor deine TLS-Zertifikate ablaufen. Letzteres hat mir schon mehr als einmal den Hintern gerettet.

Warum Monitoring im Homelab kein Luxus ist

Wer Immich, Nextcloud oder Pi-hole betreibt, hat sich Verantwortung ins Haus geholt. Die Familie verlässt sich darauf, dass Fotos gesichert werden, Dateien synchron sind und Werbung geblockt wird. Fällt Pi-hole aus und ist als einziger DNS-Server eingetragen, ist für alle im Haus „das Internet kaputt“ – und du bekommst das über den Flurfunk mitgeteilt statt über eine Push-Nachricht.

Der Unterschied zwischen „Ausfall bemerken“ und „Ausfall entdecken“ sind oft Stunden oder Tage. Und noch etwas: Die Historie in Uptime Kuma zeigt schleichende Probleme, bevor sie zum Ausfall werden. Wenn die Antwortzeiten deiner Nextcloud über Wochen langsam steigen, ist vielleicht die Festplatte auf dem Weg ins Jenseits oder ein Backup-Job frisst nachts alle Ressourcen. Ohne Monitoring siehst du das schlicht nicht.

Installation mit Docker

Uptime Kuma läuft praktisch überall, wo Docker läuft – auf dem Raspberry Pi als Homeserver genauso wie auf einem ausgewachsenen NAS oder einer VM. Die aktuelle Hauptversion ist 2.x, und die solltest du auch nehmen. Ein einzelner Befehl genügt:

docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

Wer seine Container lieber sauber in Compose-Dateien verwaltet – etwa über Portainer –, nimmt diesen Block:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    container_name: uptime-kuma
    restart: always
    ports:
      - "3001:3001"
    volumes:
      - uptime-kuma:/app/data
volumes:
  uptime-kuma:

Nach dem Start rufst du im Browser http://server-ip:3001 auf. Beim ersten Besuch legst du ein Admin-Konto an – nimm ein ordentliches Passwort, denn wer Zugriff auf dein Monitoring hat, sieht eine komplette Landkarte deines Netzwerks. Das war’s schon. Keine Datenbank aufsetzen, keine Konfigurationsdateien editieren – Uptime Kuma bringt alles mit.

Die ersten Monitore anlegen

Die leere Oberfläche verführt dazu, wild drauflos zu klicken. Besser ist ein System. Hier sind fünf Monitore, mit denen ich in jedem Homelab starten würde:

1. Router und Internet per Ping: Lege einen Ping-Monitor auf deinen Router (z. B. 192.168.1.1) und einen zweiten auf eine externe Adresse wie 1.1.1.1 an. So siehst du sofort, ob ein Problem im Heimnetz oder beim Provider liegt – das erspart dir viel Rätselraten.
2. Pi-hole oder AdGuard per HTTP: Ein HTTP-Monitor auf http://pi-hole-ip/admin/ meldet, wenn der Werbeblocker ausfällt. Gerade weil Pi-hole als DNS-Server das ganze Netz betrifft, gehört er ganz nach oben auf die Liste.
3. Nextcloud oder Immich per HTTPS mit Keyword: Hier lohnt der Keyword-Check: Prüfe nicht nur, ob die Seite antwortet, sondern ob z. B. das Wort „Nextcloud“ oder „Login“ im HTML steht. Ein Reverse Proxy, der eine 502-Fehlerseite mit Status 200 ausliefert, fliegt sonst unter dem Radar durch.
4. NAS per TCP-Port: Ein TCP-Monitor auf Port 445 (SMB) oder 22 (SSH) sagt dir, ob die Dateifreigabe noch lebt – auch wenn das NAS keine Weboberfläche hat oder diese abgeschaltet ist.
5. Zertifikats-Ablauf für die eigene Domain: Bei jedem HTTPS-Monitor kannst du „Certificate Expiry Notification“ aktivieren. Uptime Kuma warnt dann rechtzeitig, bevor dein Let’s-Encrypt-Zertifikat abläuft – falls die automatische Erneuerung mal klemmt.

Zwei Einstellungen entscheiden darüber, ob dein Monitoring nervt oder hilft: das Intervall und die Retries. Ein Check alle 60 Sekunden reicht im Homelab völlig aus, für unkritische Dienste dürfen es auch 300 Sekunden sein. Alles darunter erzeugt nur Last und Log-Rauschen. Und stelle die Retries auf 2 oder 3: Erst wenn ein Check mehrfach hintereinander fehlschlägt, gilt der Dienst als down. Das filtert kurze Netzwerk-Schluckaufe zuverlässig raus.

Benachrichtigungen einrichten: Telegram und Ntfy

Ein Monitoring, das niemanden benachrichtigt, ist nur ein hübsches Dashboard. Der mit Abstand beliebteste Weg ist ein Telegram-Bot – kostenlos, zuverlässig und in fünf Minuten eingerichtet:

1. Öffne in Telegram einen Chat mit @BotFather und sende /newbot. Vergib einen Namen und einen Bot-Nutzernamen.
2. Der BotFather antwortet mit einem API-Token – kopiere es.
3. Schreibe deinem neuen Bot eine beliebige Nachricht (er darf dir sonst nicht antworten).
4. In Uptime Kuma: Profil-Menü → Einstellungen → Benachrichtigungen → Benachrichtigung einrichten → Typ „Telegram“. Token einfügen – die Chat-ID holt sich Uptime Kuma auf Knopfdruck automatisch.
5. Mit Test prüfen, ob die Nachricht ankommt, speichern, fertig.

Wer kein Telegram mag, sollte sich Ntfy ansehen: ein schlanker, selbsthostbarer Push-Dienst, der wunderbar zur Homelab-Philosophie passt. In Uptime Kuma einfach als Benachrichtigungstyp „ntfy“ wählen, Server und Topic eintragen, App aufs Handy – läuft.

Ein Wort der Warnung aus eigener Erfahrung: Hänge nicht jeden Monitor an jede Benachrichtigung. Wenn dein Handy bei jedem Container-Neustart um drei Uhr nachts vibriert, schaltest du die Benachrichtigungen nach zwei Wochen komplett ab – und verpasst dann den echten Ausfall. Alarm-Müdigkeit ist der Tod jedes Monitorings. Kritische Dienste (DNS, Internet, Backups) dürfen pushen, alles andere reicht als E-Mail oder taucht nur im Dashboard auf.

Status-Seite bauen

Uptime Kuma kann mehrere Status-Seiten erzeugen – aufgeräumte Übersichten, die nur ausgewählte Monitore zeigen. Unter Status-Seiten legst du eine neue Seite an, ziehst die gewünschten Monitore in Gruppen („Internet“, „Dienste“, „Geräte“) und bekommst eine eigene URL.

Das ist praktischer, als es klingt: Die Familie kann selbst nachsehen, ob die Fotocloud gerade wirklich down ist oder nur das WLAN am Handy zickt. Und am Wand-Tablet macht sich so eine Status-Seite hervorragend als Ergänzung zum Home-Assistant-Dashboard – ein Blick im Vorbeigehen und du weißt, dass alles grün ist. Wichtig: Überlege dir, ob die Seite wirklich öffentlich erreichbar sein muss. Für den Hausgebrauch reicht die interne Erreichbarkeit völlig, und du verrätst dem Internet nicht, welche Dienste bei dir laufen.

Das Henne-Ei-Problem: Wer überwacht den Wächter?

Jetzt zur unbequemen Wahrheit: Wenn Uptime Kuma auf demselben Server läuft wie die Dienste, die es überwacht, ist es beim Totalausfall genauso tot wie alles andere. Der Server hängt sich auf – und niemand meldet es, weil der Melder mit hängt.

Die pragmatische Lösung im Homelab: Uptime Kuma auf separate Hardware setzen. Ein Raspberry Pi ist dafür wie gemacht – er braucht kaum Strom, langweilt sich mit Uptime Kuma zu Tode und steht idealerweise an einer anderen Steckdose als der Hauptserver. Fällt der große Server aus, meldet sich der kleine Wächter. Fällt der Pi aus, merkst du das am ausbleibenden Grün im Dashboard. Ein perfektes System gibt es nicht, aber zwei unabhängige Geräte sind um Welten besser als eines.

Und dann gibt es noch eine Monitor-Art, die viele übersehen: den Push-Monitor. Der funktioniert genau andersherum – Uptime Kuma prüft nichts aktiv, sondern erwartet, dass sich ein Dienst regelmäßig selbst meldet. Uptime Kuma generiert dazu eine URL, die dein Backup-Skript oder Cronjob am Ende einfach per curl aufruft. Bleibt das Signal aus, schlägt der Monitor Alarm. Das nennt sich Dead Man’s Switch, und es ist die einzige zuverlässige Antwort auf die Frage: „Läuft mein nächtliches Backup eigentlich noch?“ Ein Backup-Job, der seit drei Monaten stillschweigend fehlschlägt, ist einer der häufigsten und schmerzhaftesten Homelab-Fehler überhaupt.

Wo die Grenzen liegen

Bei aller Liebe – Uptime Kuma ist ein Verfügbarkeits-Monitor, kein vollwertiges Monitoring-System. Es sagt dir, ob ein Dienst antwortet, aber nicht, wie gut es ihm geht: CPU-Last, RAM-Verbrauch und volllaufende Festplatten sieht es nicht. Für Metriken dieser Art sind Grafana mit Prometheus oder das unkomplizierte Netdata die richtigen Werkzeuge.

Außerdem ist Uptime Kuma als Einzelinstanz konzipiert – Hochverfügbarkeit oder verteilte Checks von mehreren Standorten gibt es nicht. Und die Daten liegen in einer SQLite-Datenbank, die mit langer Historie und vielen Monitoren wachsen kann. Stelle in den Einstellungen eine vernünftige Aufbewahrungsdauer ein (90 bis 180 Tage reichen) und nimm das Datenverzeichnis in dein Backup auf. Für das Homelab sind das alles verschmerzbare Grenzen – man sollte sie nur kennen.

Troubleshooting: Die drei häufigsten Probleme

Ständige Fehlalarme: Fast immer ist das Intervall zu aggressiv oder die Retries stehen auf 0. Intervall auf mindestens 60 Sekunden, Retries auf 2–3, und die meisten Phantom-Ausfälle verschwinden. Häufen sich die Wackler bei einem bestimmten Gerät, ist das übrigens selbst ein wertvoller Hinweis – etwa auf ein WLAN-Problem.

Monitor zeigt „down“, obwohl der Dienst läuft: Die Klassiker sind DNS (kann der Uptime-Kuma-Host den Namen überhaupt auflösen? Teste mit der IP), Firewall-Regeln zwischen VLANs und selbstsignierte Zertifikate. Für Letztere gibt es im Monitor die Option „Ignore TLS/SSL error“ – bei internen Diensten mit eigenem Zertifikat völlig legitim.

Benachrichtigung kommt nicht an: Erst den Test-Button in der Benachrichtigungs-Konfiguration drücken. Kommt die Testnachricht an, ist die Benachrichtigung schlicht nicht dem Monitor zugewiesen – das passiert öfter, als man denkt. Kommt sie nicht an, liegt es an Token, Chat-ID oder (bei E-Mail) an den SMTP-Daten.

Fazit

Uptime Kuma ist eines dieser seltenen Tools, die in zehn Minuten installiert sind und trotzdem dauerhaft im Einsatz bleiben. Es kostet nichts, läuft auf einem Raspberry Pi und verwandelt dein Homelab vom Blindflug in einen kontrollierten Betrieb: Du erfährst von Ausfällen per Push statt per Familienbeschwerde, siehst schleichende Probleme in der Historie und bekommst mit Push-Monitoren endlich Gewissheit über deine Backups. Mein Rat: Fang mit den fünf Monitoren aus diesem Artikel an, richte Telegram ein und widerstehe der Versuchung, alles an jede Benachrichtigung zu hängen. Ein ruhiges Monitoring, dem du vertraust, ist mehr wert als ein lautes, das du ignorierst.

Häufige Fragen

Ist Uptime Kuma kostenlos?

Ja, vollständig. Uptime Kuma ist Open Source (MIT-Lizenz) und kostet weder in der Anschaffung noch im Betrieb etwas. Es gibt keine Premium-Version und keine künstlichen Limits – du zahlst nur mit dem Strom, den der Host verbraucht.

Läuft Uptime Kuma auf dem Raspberry Pi?

Sehr gut sogar. Es gibt offizielle ARM-Images für Docker, und selbst ein Raspberry Pi 3 reicht für Dutzende Monitore. Ein Pi 4 oder 5 langweilt sich damit – was ihn zum idealen separaten Wächter für den Hauptserver macht.

Kann ich Dienste hinter einem VPN überwachen?

Ja, solange der Host, auf dem Uptime Kuma läuft, die Dienste erreichen kann. Läuft auf dem Monitoring-Host ein WireGuard- oder Tailscale-Client, kannst du problemlos Dienste am anderen Ende des Tunnels prüfen – etwa den Server bei den Eltern oder einen VPS.

Was ist ein Push-Monitor?

Ein umgekehrter Check: Statt dass Uptime Kuma aktiv anfragt, muss sich der überwachte Job regelmäßig selbst per URL-Aufruf melden. Bleibt das Signal aus, gibt es Alarm. Ideal für Backups, Cronjobs und Skripte – alles, was keinen Port offen hat, aber zuverlässig laufen soll.

Uptime Kuma oder Grafana?

Beides – sie beantworten verschiedene Fragen. Uptime Kuma sagt dir, ob ein Dienst erreichbar ist, und alarmiert beim Ausfall. Grafana (mit Prometheus oder InfluxDB) zeigt dir Metriken wie CPU, RAM und Plattenplatz im Zeitverlauf. Im Homelab ist Uptime Kuma der einfachere Einstieg; Grafana kommt dazu, wenn du wissen willst, warum etwas langsam ist.