Zum Inhalt springen
SONOYA.com
Selfhosting & Web

Uptime Kuma einrichten: Websites und Dienste überwachen

Uptime Kuma 2 mit Docker Compose installieren, Websites und SSL-Zertifikate überwachen, per ntfy oder Telegram alarmieren und eine Statusseite anlegen.

Von

Herzschlag-Linie auf dunkelgrünem Verlauf als Symbol für Uptime Kuma, das Websites und Dienste rund um die Uhr auf Erreichbarkeit prüft

Dass Deine Website down ist, erfährst Du im ungünstigsten Fall von einem Kunden, und dass das SSL-Zertifikat abgelaufen ist, von der Warnseite im Browser. Uptime Kuma dreht das um: Das kostenlose Open-Source-Werkzeug prüft Websites, Server und Dienste im Minutentakt und meldet sich bei Dir, sobald etwas nicht stimmt. Hier installieren wir Uptime Kuma per Docker Compose mit HTTPS, legen die wichtigsten Monitore an, lassen uns vor ablaufenden Zertifikaten warnen, schicken Alarme per ntfy oder Telegram und bauen eine öffentliche Statusseite.

Die Anleitung gilt für Uptime Kuma 2.5, laut den Releases auf GitHub im November 2026 die aktuelle stabile Version. Getestet ist der Ablauf mit dem offiziellen Image louislam/uptime-kuma:2 (Version 2.5.12) unter Docker 29: Start, Datenbank-Einrichtung mit SQLite und die Push-Schnittstelle. Die Klickwege in der Oberfläche sind mit den deutschen Sprachdateien dieser Version abgeglichen.

Wo Uptime Kuma laufen sollte

Die wichtigste Entscheidung fällt vor der Installation: Uptime Kuma gehört nicht auf den Server, den es überwachen soll. Fällt dieser Server aus, fällt die Überwachung mit aus, und Du bekommst genau dann keine Nachricht, wenn Du sie brauchst. Dasselbe gilt für einen Raspberry Pi im Heimnetz, der Deine Website im Rechenzentrum prüft: Ist Dein Internetanschluss weg, meldet er entweder nichts oder einen Fehlalarm.

Am zuverlässigsten ist ein kleiner, eigener Server bei einem anderen Anbieter oder zumindest in einem anderen Rechenzentrum als Deine Website. Uptime Kuma ist genügsam, im Test brauchte der Container im Leerlauf rund 140 MB Arbeitsspeicher. Ein Droplet mit 1 GB RAM reicht deshalb für Dutzende Monitore. Wenn Du noch kein Konto hast, bekommst Du über diesen Link zu DigitalOcean (Affiliate Link) Startguthaben zum Ausprobieren. Dienste im Heimnetz, die von außen nicht erreichbar sind, überwachst Du trotzdem von dort aus, mit einem Push-Monitor (siehe unten).

Was Du brauchst

  • Einen Linux-Server mit Docker und Docker Compose, etwa Ubuntu 26.04 LTS oder Debian 13.
  • Eine Subdomain wie status.example.com, deren DNS-Eintrag (A-Record) auf die IP-Adresse des Servers zeigt.
  • Offene Ports 80 und 443, damit Caddy ein Zertifikat von Let’s Encrypt holen kann.

Wenn Docker Compose für Dich noch neu ist, erklärt Docker Compose verstehen: Volumes, Netzwerke und .env die Grundlagen, auf die diese Anleitung aufbaut.

Uptime Kuma mit Docker Compose installieren

Melde Dich per SSH auf Deinem Server an, lege einen Ordner an und wechsle hinein:

Code
mkdir -p ~/uptime-kuma
cd ~/uptime-kuma

Erstelle mit nano compose.yaml die Compose-Datei mit diesem Inhalt:

Code
services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data

  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./caddy-data:/data

Speichere mit Strg + O, bestätige mit Enter und schließe den Editor mit Strg + X. Der Uptime-Kuma-Teil entspricht der offiziellen compose.yaml des Projekts, mit einem Unterschied: Die Zeile ports fehlt bewusst. Uptime Kuma ist damit nur für Caddy im gemeinsamen Docker-Netz erreichbar und nicht ungeschützt über Port 3001 aus dem Internet. Das ist auch deshalb wichtig, weil von Docker veröffentlichte Ports an einer Firewall wie ufw vorbeigehen. Die Daten landen im Ordner ./data neben der Compose-Datei. Leg ihn auf eine lokale Platte, denn laut Projekt werden Netzlaufwerke wie NFS nicht unterstützt.

Lege dann mit nano Caddyfile die Konfiguration für den Reverse Proxy an:

Code
status.example.com {
    reverse_proxy uptime-kuma:3001
}

Ersetze status.example.com durch Deine Subdomain. Caddy holt dafür automatisch ein Zertifikat und reicht alle Anfragen an den Uptime-Kuma-Container weiter, auch die WebSocket-Verbindung, über die die Oberfläche live aktualisiert wird. Läuft auf Deinem Server bereits Coolify oder ein anderer Reverse Proxy, lässt Du den Caddy-Dienst weg und trägst die Domain dort ein.

Starte beide Container:

Code
docker compose up -d

Docker lädt die Images und startet sie im Hintergrund. Mit docker compose logs -f uptime-kuma siehst Du, was passiert. Sobald die Zeile Waiting for user action... erscheint, beendest Du die Anzeige mit Strg + C.

Der erste Start: Datenbank und Admin-Konto

Öffne https://status.example.com im Browser. Uptime Kuma 2 fragt zuerst Welche Datenbank möchtest du verwenden? und bietet Embedded MariaDB, MariaDB/MySQL und SQLite an. Wähl SQLite. Das ist eine einzelne Datei im Ordner data, ohne zusätzlichen Datenbankdienst, und laut Projekt die Empfehlung für kleinere Installationen. Nach einem Klick auf Weiter richtet Uptime Kuma die Datenbank ein, das dauert einige Sekunden.

Danach legst Du unter Erstelle dein Administrator-Konto Benutzername und Passwort an. Nimm ein langes, eigenes Passwort, denn die Anmeldeseite ist öffentlich erreichbar. Unter Einstellungen > Sicherheit kannst Du anschließend mit 2FA einrichten eine Zwei-Faktor-Anmeldung per Authenticator-App ergänzen.

Zwei Einstellungen solltest Du gleich setzen. Trage unter Einstellungen > Allgemein bei Primäre Basis-URL Deine Adresse https://status.example.com ein, damit Links in Benachrichtigungen und Push-URLs stimmen. Stell außerdem unter Einstellungen > Reverse-Proxy die Option Proxy vertrauen auf Ja, weil Uptime Kuma hinter Caddy sonst nicht die echte IP-Adresse der Besucher sieht. Beide Seiten bestätigst Du mit Speichern.

Benachrichtigung einrichten: ntfy oder Telegram

Richte den Kanal für Alarme ein, bevor Du Monitore anlegst. Dann kannst Du ihn jedem neuen Monitor sofort mitgeben. Öffne Einstellungen > Benachrichtigungen und klicke auf Benachrichtigung einrichten.

Mit ntfy. Wähl als Benachrichtigungstyp den Eintrag Ntfy. Trag unter Server-URL die Adresse Deines ntfy-Servers ein, also etwa https://ntfy.example.com ohne Kanalnamen am Ende, und unter ntfy-Topic einen Kanal wie monitoring. Bei Authentifizierungsmethode wählst Du Zugriffstoken und fügst den Token ein. Wie Du den ntfy-Server selbst betreibst und den Token erzeugst, steht in Push-Benachrichtigungen selbst hosten mit ntfy.

Mit Telegram. Schreib in Telegram dem offiziellen Konto @BotFather die Nachricht /newbot, vergib einen Namen und kopiere den Token, den er Dir zurückschickt. Der Ablauf ist in der Bot-Doku von Telegram beschrieben. Wähl in Uptime Kuma den Typ Telegram und füge den Token unter Bot-Token ein. Öffne dann den Chat mit Deinem neuen Bot, tippe auf Start und schick ihm eine beliebige Nachricht. Erst danach findet Uptime Kuma Deine Chat-ID, wenn Du neben dem Feld Chat-ID auf Automatisch abrufen klickst.

Setz bei beiden Varianten den Haken bei Standardmäßig aktiviert, damit jeder neue Monitor diesen Kanal automatisch bekommt. Klicke auf Testen. Kommt die Testnachricht auf dem Handy an, speicherst Du mit Speichern.

Monitore anlegen

Klicke oben links auf Neuen Monitor hinzufügen. Jeder Monitor hat einen Monitortyp, einen Anzeigenamen und ein Heartbeat-Intervall, das standardmäßig bei 60 Sekunden liegt. Stell Wiederholungen auf 2: Dann prüft Uptime Kuma nach einem Fehlschlag zweimal nach, bevor es Alarm schlägt, und ein kurzer Aussetzer weckt Dich nicht. Seit Version 2 steht dieser Wert bei neuen Monitoren auf 0. Für die meisten Fälle reichen diese fünf Typen:

  • HTTP(s) ruft eine Adresse auf und gilt als erreichbar, wenn ein Statuscode zwischen 200 und 299 zurückkommt. Das ist der Standard für Websites.
  • HTTP(s) - Schlüsselwort prüft zusätzlich, ob ein bestimmter Text auf der Seite steht. Nimm etwas, das nur auf der funktionierenden Seite vorkommt, etwa den Namen im Footer. So fällt auch auf, wenn der Server zwar antwortet, aber nur eine Fehlerseite ausliefert.
  • TCP Port prüft, ob ein Port Verbindungen annimmt, zum Beispiel 22 für SSH oder 25 für einen Mailserver.
  • DNS fragt einen Eintrag ab, standardmäßig den A-Record über Cloudflare. Damit merkst Du, wenn eine Domain plötzlich nicht mehr auflöst.
  • Push dreht die Richtung um und wartet darauf, dass sich ein Gerät oder Skript meldet. Dazu gleich mehr.

Für eine Website wählst Du HTTP(s) - Schlüsselwort, trägst die URL und unter Schlüsselwort den gesuchten Text ein und klickst auf Speichern. Nach einer Minute erscheint der erste grüne Balken im Dashboard.

Zertifikatsablauf überwachen

Ein abgelaufenes Zertifikat ist einer der häufigsten Ausfälle, weil die Seite technisch läuft und Browser sie trotzdem blockieren. Uptime Kuma liest bei jedem HTTPS-Aufruf das Zertifikat mit aus, warnt aber nur, wenn Du es einschaltest: Setz im Monitor unter Erweitert den Haken bei Benachrichtigung bei Zertifikatsablauf. Der Haken ist ab Werk aus und lässt sich nicht setzen, solange TLS/SSL-Fehler für HTTPS-Websites ignorieren aktiv ist.

Wann gewarnt wird, legst Du für alle Monitore gemeinsam unter Einstellungen > Benachrichtigungen fest. Voreingestellt sind 7, 14 und 21 Tage vor Ablauf. Für Let’s-Encrypt-Zertifikate mit der heute üblichen Laufzeit von 90 Tagen, die Caddy und andere Clients rund 30 Tage vor Ablauf erneuern, ist das passend: Kommt die erste Warnung, ist die automatische Erneuerung bereits gescheitert, und Du hast noch drei Wochen Zeit.

Direkt darunter steht im Monitor Benachrichtigung bei Domain-Ablauf. Diese Funktion gibt es seit Version 2.1, sie ist ab Werk eingeschaltet und fragt das Ablaufdatum der Domain selbst ab. Für Domains, deren Registry keinen passenden Abfragedienst anbietet, zeigt Uptime Kuma einen Hinweis an, dann bleibt die Funktion wirkungslos.

Push-Monitor: Dienste ohne öffentliche Adresse

Ein Backup-Skript, Home Assistant oder ein Rechner hinter DS-Lite ist von außen nicht erreichbar. Hier legst Du einen Monitor vom Typ Push an, stellst das Heartbeat-Intervall zum Beispiel auf 600 Sekunden und kopierst die angezeigte Push-URL. Sie sieht so aus:

Code
https://status.example.com/api/push/AbC123xYz?status=up&msg=OK&ping=

Der Teil nach /api/push/ ist ein geheimer Schlüssel, den Uptime Kuma für diesen Monitor erzeugt. Damit sich ein Linux-Rechner im Heimnetz alle fünf Minuten meldet, öffnest Du dort mit crontab -e die Cron-Tabelle und ergänzt eine Zeile, in der Du die Adresse durch Deine eigene Push-URL ersetzt:

Code
*/5 * * * * curl -fsS -m 10 -o /dev/null "https://status.example.com/api/push/AbC123xYz?status=up&msg=OK&ping="

Bleibt der Aufruf länger als das eingestellte Intervall aus, meldet Uptime Kuma den Monitor als ausgefallen. Wie Du auf diese Weise ein Android-Handy überwachst, das dauerhaft laufen soll, zeigt Android-Handy per Heartbeat in Uptime Kuma überwachen.

Eine Statusseite anlegen

Eine Statusseite zeigt Besuchern oder Kunden ohne Anmeldung, welche Dienste gerade laufen. Öffne oben Statusseiten, klicke auf Neue Statusseite, vergib einen Namen und einen Slug wie dienste und klicke auf Weiter. Im Bearbeitungsmodus wählst Du im Feld Monitor hinzufügen die Monitore aus, die öffentlich zu sehen sein sollen, ergänzt bei Bedarf eine Beschreibung und klickst auf Speichern. Die Seite ist danach unter https://status.example.com/status/dienste erreichbar. Nimm nur Monitore auf, deren Namen Du öffentlich zeigen willst, denn interne Rechnernamen haben dort nichts verloren.

Wenn etwas nicht klappt

Die Seite lädt nicht oder zeigt einen Zertifikatsfehler. Fast immer zeigt der DNS-Eintrag noch nicht auf den Server, oder Port 80 und 443 sind zu. Mit docker compose logs caddy siehst Du, ob Caddy das Zertifikat bekommen hat.

Ein Push-Monitor meldet ständig einen Ausfall. Ruf die Push-URL einmal von Hand mit curl auf. Kommt {"ok":true} zurück, stimmt die Adresse, und der Fehler liegt beim Cronjob. Die Antwort {"ok":false,"msg":"Monitor not found or not active."} bedeutet, dass der Schlüssel falsch ist oder der Monitor pausiert.

Eine Website wird als ausgefallen gemeldet, läuft aber im Browser. Klick im Dashboard auf den Monitor und lies unter den Balken in der Ereignisliste die Nachricht zum Ausfall. Steht dort ein Statuscode wie 403, blockiert eine Firewall oder ein Bot-Schutz vor der Website die Anfragen Deines Servers. Gib die IP-Adresse des Monitoring-Servers dort frei.

Updates und Sicherung

Für ein Update lädst Du die neuen Images und startest die Container neu:

Code
docker compose pull
docker compose up -d

Das Tag :2 bleibt dabei auf der Hauptversion 2. Die Version 3 ist im November 2026 noch eine Beta mit größeren Umbauten, warte mit dem Wechsel, bis sie stabil ist und Du die Hinweise in den Release Notes gelesen hast. Wenn Du nicht blind aktualisieren, sondern über neue Versionen informiert werden willst, hilft Docker-Container aktualisieren: Diun statt Watchtower.

Gesichert wird seit Version 2 nur noch der Ordner data, der frühere Export als JSON-Datei ist laut Migrationshinweisen entfallen. Halte vor dem Kopieren mit docker compose stop uptime-kuma den Container an, damit die SQLite-Datenbank in einem sauberen Zustand ist, und starte ihn danach mit docker compose start uptime-kuma wieder.

Fazit

Mit zwei Containern auf einem kleinen, separaten Server erfährst Du ab jetzt als Erster, wenn eine Website hängt, ein Port nicht antwortet oder ein Zertifikat bald abläuft. Vergiss dabei nicht den Haken für den Zertifikatsablauf, denn er ist ab Werk aus. Danach lohnen sich Push-Monitore für Backups und Geräte im Heimnetz, weil gerade still ausfallende Dinge sonst am spätesten auffallen.

Weiterlesen.