Uptime Kuma: Verfügbarkeitsüberwachung auf Ihrem eigenen Server
Ein selbst gehosteter Monitor, der Ihre Websites und Dienste jede Minute prüft und Ihnen sofort Bescheid gibt, wenn einer davon nicht mehr antwortet.
Über Uptime Kuma
Uptime Kuma ist ein Open-Source-Monitoring-Werkzeug, das der Entwickler Louis Lam gestartet hat und das heute zu den selbst gehosteten Projekten mit den meisten Sternen auf GitHub gehört. Es prüft, ob Dinge antworten: Websites über HTTP(S), Schlüsselwörter auf einer Seite, TCP-Ports, Ping, DNS-Einträge, Datenbanken und mehr.
Schlägt eine Prüfung fehl, verschickt Uptime Kuma eine Benachrichtigung über einen von Dutzenden unterstützten Kanälen, darunter Telegram, Discord, Slack, E-Mail und Webhooks. Außerdem erfasst es Antwortzeiten, warnt vor dem Ablauf von TLS-Zertifikaten und ermöglicht öffentliche Statusseiten für Ihre Kunden.
Viele hosten Uptime Kuma selbst, weil es schlank und kostenlos ist und eine aufgeräumte Oberfläche hat, die in wenigen Minuten eingerichtet ist. Entscheidend ist ein separater Server: Ein Monitor auf derselben Maschine wie Ihre Website kann Ihnen nicht melden, wenn genau diese Maschine ausfällt.
Wofür es genutzt wird
Alarm, wenn eine Website ausfällt
Prüfen Sie Ihre Website und API jede Minute und erhalten Sie eine Nachricht per Telegram oder E-Mail, sobald sie nicht mehr antworten.
Warnungen vor ablaufenden Zertifikaten
Lassen Sie sich Tage vor dem Ablauf eines HTTPS-Zertifikats erinnern, statt es von Ihren Kunden zu erfahren.
Eine öffentliche Statusseite
Zeigen Sie Kunden den aktuellen Zustand Ihrer Dienste auf einer Seite, die Sie kontrollieren.
Nach der Bestellung
Beim ersten Start des Servers wird Uptime Kuma installiert und Port 3001 in der Firewall geöffnet; der Monitor ist dann unter http://ihre-serveradresse:3001/ erreichbar. Beim ersten Aufruf legen Sie das Administratorkonto an – öffnen Sie die Adresse also, sobald der Server bereit ist. Fügen Sie danach Ihren ersten Monitor hinzu und verbinden Sie einen Benachrichtigungskanal.
Wo Uptime Kuma laufen sollte
Uptime Kuma prüft von dort aus, wo es läuft. Ein Monitor auf demselben Server wie die überwachten Dienste fällt zusammen mit ihnen aus und kann Sie nicht warnen – betreiben Sie ihn daher auf einem anderen Server als das, was er überwacht.
Eigene Domain und HTTPS für Uptime Kuma
Ab Werk antwortet Uptime Kuma unter der IP-Adresse des Servers über unverschlüsseltes HTTP. Um einen Namen wie status.example.com mit Zertifikat zu vergeben, legen Sie in Ihrem DNS für diesen Namen einen A-Eintrag an, der auf die IPv4-Adresse des Servers zeigt, und setzen dann Caddy davor: Caddy holt sich selbst ein kostenloses Let's-Encrypt-Zertifikat und verlängert es. Die folgenden Befehle gelten für Ubuntu 24.04, auf dem unsere App-Server laufen.
Öffnen Sie im Panel die TCP-Ports 80 und 443 in der Firewall des Servers: Caddy braucht sie, um das Let's-Encrypt-Zertifikat zu erhalten und die Website auszuliefern.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyMit einer Domain davor lassen sich die Statusseiten von Uptime Kuma mit Ihren Kunden teilen: Legen Sie eine Statusseite an, wählen Sie die Monitore aus, die sie zeigen soll, und geben Sie https://status.example.com/status/ihre-seite weiter. Sie können die Domain auch direkt in den Einstellungen einer Statusseite hinterlegen.
Sobald die Domain funktioniert, braucht niemand mehr den direkten Port 3001: Ändern Sie in /opt/uptime-kuma/compose.yml "3001:…" in "127.0.0.1:3001:…", führen Sie docker compose up -d aus und entfernen Sie Port 3001 aus der Firewall. Uptime Kuma ist dann nur noch über HTTPS erreichbar.
Uptime Kuma aktualisieren
Die Images in /opt/uptime-kuma/compose.yml sind auf exakte Versionen festgelegt, ein einfaches docker compose pull holt also wieder dieselbe Version. Für ein Update ändern Sie die Version in der Zeile image: auf die gewünschte (lesen Sie vorher die Release Notes), laden die Images und erstellen die Container neu. Die Daten liegen in Docker-Volumes und bleiben erhalten.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dUptime Kuma sichern
Im Panel können Sie tägliche Backups des gesamten Servers aktivieren (+20 % des Tarifpreises, die letzten 7 Kopien werden aufbewahrt) und den Server aus jeder dieser Kopien wiederherstellen. Eine Kopie der Anwendungsdaten als Datei lohnt sich trotzdem: Sie lässt sich auf einen anderen Server übertragen oder wiederherstellen, ohne alles andere zurückzusetzen.
Monitore, Benachrichtigungseinstellungen und der Prüfverlauf liegen im Volume uptime-kuma_uptime_kuma (/app/data). Stoppen Sie die App kurz, damit die Datenbankdatei in einem konsistenten Zustand kopiert wird:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startSo funktioniert es
- Wählen Sie Uptime Kuma auf der Bestellseite für den Server und einen Tarif mit genügend Arbeitsspeicher.
- Die App wird beim ersten Start auf dem Server installiert, meist innerhalb weniger Minuten.
- Öffnen Sie den Server in Ihrem Panel: Dort finden Sie Adresse und Zugangsdaten.