Über Uptime Kuma
Uptime Kuma ist ein selbst gehostetes Monitoring-Tool, entwickelt von Louis Lam und seiner Community unter MIT-Lizenz. Es prüft in regelmäßigen Abständen Ihre Websites, APIs, TCP-Ports, Hosts (Ping), DNS-Einträge oder Docker-Container. Antwortet etwas nicht mehr, benachrichtigt es Sie per Telegram, Discord, Slack, E-Mail oder Webhook. Die Oberfläche ist übersichtlich und lässt sich ohne Dokumentation bedienen.
Gedacht ist es für Entwickler, Agenturen und kleine Teams, die einen Ausfall vor ihren Kunden bemerken wollen, ohne pro Monitor ein SaaS-Abonnement zu bezahlen. Läuft das Tool auf Ihrem eigenen VPS, behalten Sie außerdem die Kontrolle über Ihre Monitoring-Daten.
Nach der Auslieferung finden Sie auf dem Server Docker, Uptime Kuma (Image louislam/uptime-kuma:2) und einen Caddy-Reverse-Proxy. Die Anwendung lauscht nur auf 127.0.0.1:3001. Caddy veröffentlicht sie per HTTPS auf Port 443 der öffentlichen IP-Adresse des Servers, mit einem selbstsignierten Zertifikat. Sie müssen nur noch die URL öffnen und das Administratorkonto anlegen.
Was Sie mit Uptime Kuma tun können
Viele Monitor-Typen
HTTP(S), Schlüsselwort auf einer Seite, TCP, Ping, DNS, Docker-Container und weitere. Sie legen das Prüfintervall fest und bestimmen, nach wie vielen Fehlversuchen ein Alarm ausgelöst wird.
Alarme über Ihre gewohnten Kanäle
Telegram, Discord, Slack, SMTP-E-Mail, Webhook und viele weitere Benachrichtigungsdienste stehen direkt in der Oberfläche bereit, ohne dass Sie ein Plugin installieren müssen.
Öffentliche Statusseiten
Sie veröffentlichen eine Statusseite Ihrer Dienste für Kunden oder Ihr Team, auf Wunsch unter Ihrer eigenen Domain.
Überwachung der TLS-Zertifikate
Uptime Kuma liest das Ablaufdatum der Zertifikate überwachter HTTPS-Seiten aus und kann Sie warnen, bevor sie auslaufen.
Docker und Caddy vorinstalliert
Zwei Container mit automatischem Neustart (
restart: always), beschrieben in einerdocker-compose.yml, die Sie anpassen und versionieren können.Daten in einem eigenen Volume
Konfiguration und Verlauf der Monitore liegen im Docker-Volume
kuma_data. Das vereinfacht Backups und Updates.
Erste Schritte mit Uptime Kuma
Von der Bestellung bis zum Produktivbetrieb in wenigen Minuten.
- 1
VPS mit Uptime Kuma bestellen
Wählen Sie im Bestellformular einen Linux-VPS (Paris oder Frankfurt) mit Debian 12, Debian 13 oder Ubuntu 20.04, 22.04, 24.04. Setzen Sie im Tab „Applications“ den Haken bei Uptime Kuma.
- 2
Auf die Auslieferung warten und die Oberfläche öffnen
Nach der Auslieferung läuft die Installation noch einige Minuten im Hintergrund (Download von Docker und den Images). Öffnen Sie danach die unten stehende URL. Der Browser zeigt eine Warnung, weil das Zertifikat selbstsigniert ist: Bestätigen Sie die Ausnahme, um fortzufahren.
Bashhttps://SERVER_IP:443 # Vérifier l'état des conteneurs en SSH : ssh root@SERVER_IP cd /opt/uptime-kuma && docker compose ps - 3
Admin-Konto und ersten Monitor anlegen
Beim ersten Aufruf fordert Uptime Kuma Sie auf, den Administrator anzulegen. Fügen Sie anschließend einen Monitor hinzu (zum Beispiel HTTP(S) für Ihre Website) und richten Sie einen Benachrichtigungskanal ein, um Alarme zu erhalten.
- 4
Für den Produktivbetrieb absichern
Legen Sie einen DNS-A-Record von YOUR_DOMAIN auf SERVER_IP an und ersetzen Sie dann die Adresse im Caddyfile durch Ihre Domain: Caddy besorgt sich ein anerkanntes Zertifikat. Die Ports 80 und 443 müssen offen bleiben, Port 22 beschränken Sie nach Möglichkeit auf Ihre IP-Adressen.
Bashcd /opt/uptime-kuma nano Caddyfile # YOUR_DOMAIN { # reverse_proxy 127.0.0.1:3001 # } docker compose restart caddy
Einsatzbereiche von Uptime Kuma
Websites und APIs überwachen
Ein HTTP-Monitor pro Website oder kritischem Endpunkt, mit Alarm per Telegram oder E-Mail, sobald der Antwortcode den erwarteten Bereich verlässt.
Statusseite für Ihre Kunden
Eine Agentur oder ein SaaS-Anbieter veröffentlicht den Zustand seiner Dienste auf einer eigenen Seite und muss nicht jede Nachfrage einzeln beantworten.
Server und interne Ports prüfen
Ping auf Ihre Maschinen, TCP auf eine Datenbank oder einen SSH-Dienst, Prüfung eines Docker-Containers: eine zentrale Sicht auf die Infrastruktur.
Zertifikatsabläufe rechtzeitig erkennen
Sie behalten das Ablaufdatum der Zertifikate Ihrer Domains im Blick und erhalten einen Alarm, bevor eine fehlgeschlagene Erneuerung eine Website lahmlegt.
Häufige Fragen zu Uptime Kuma
Das Rezept konfiguriert Caddy mit tls internal, wodurch ein selbstsigniertes Zertifikat für die IP-Adresse des Servers entsteht. Die Verschlüsselung ist aktiv, der Browser kann den Aussteller aber nicht prüfen. Ordnen Sie dem Server eine Domain zu und passen Sie das Caddyfile an, um ein anerkanntes Zertifikat zu erhalten.
Mehr über Uptime Kuma
Speicherort der Dateien
Alles liegt in /opt/uptime-kuma: das Installationsskript install-uptime-kuma.sh, die Datei docker-compose.yml und das Caddyfile. Caddy läuft mit network_mode: host und liest das Caddyfile schreibgeschützt.
Führen Sie das Installationsskript nach einer Änderung am Caddyfile nicht erneut aus: Es schreibt die Datei mit der öffentlichen IP-Adresse neu, und Ihre Domain-Konfiguration ginge verloren. Um eine Änderung zu übernehmen, verwenden Sie docker compose restart caddy.
Von der IP-Adresse auf eine Domain umstellen
Standardmäßig enthält das Caddyfile https://IP_PUBLIQUE:443 mit tls internal, daher das selbstsignierte Zertifikat. Ersetzen Sie diese Zeile durch einen Domainnamen und entfernen Sie tls internal, dann fordert Caddy selbstständig ein öffentliches Zertifikat an und erneuert es. Der DNS-Eintrag muss dafür bereits auf den Server zeigen, sonst schlägt die Anfrage fehl.
Backups
Die Daten von Uptime Kuma liegen im Docker-Volume kuma_data. Am sichersten stoppen Sie den Container für die Dauer der Kopie und archivieren das Volume anschließend.
Bashcd /opt/uptime-kuma docker compose stop uptime-kuma docker volume ls | grep kuma_data docker run --rm -v uptime-kuma_kuma_data:/data -v $(pwd):/backup alpine \ tar czf /backup/kuma-backup.tar.gz -C /data . docker compose start uptime-kuma
Der genaue Name des Volumes hängt vom Projektordner ab; prüfen Sie ihn mit docker volume ls. Kopieren Sie das Archiv danach vom Server weg. Ein Snapshot des VPS ist eine sinnvolle Ergänzung.
Updates
Das Image verwendet den Tag 2, der den Versionen 2.x folgt. Um die neueste Version zu holen, erstellen Sie zuerst ein Backup und führen dann Folgendes aus:
Bashcd /opt/uptime-kuma docker compose pull docker compose up -d
Wo das Monitoring laufen sollte
Ein Monitor, der auf dem überwachten Server selbst läuft, meldet sich nicht, wenn genau dieser Server komplett ausfällt. Für wichtige Dienste installieren Sie Uptime Kuma deshalb auf einem separaten VPS, zum Beispiel am jeweils anderen Standort (Paris oder Frankfurt). Weitere Anleitungen finden Sie in unseren Tutorials.

