Diese Anleitung zeigt, wie Sie Uptime Kuma auf einem eigenen Seed einrichten, als One-Click-App oder per Docker Compose mit Caddy. Danach legen Sie die ersten Monitore an, richten Benachrichtigungen ein und veröffentlichen eine Statusseite. Mit der One-Click-App dauert das rund 10 Minuten.
Was ist Uptime Kuma?
Uptime Kuma prüft regelmäßig, ob Ihre Websites, Server und Dienste erreichbar sind, und meldet sich, sobald etwas ausfällt. Alles läuft über eine Weboberfläche.
- Monitore: HTTP(S) mit Statuscode oder Schlüsselwort, TCP-Ports, Ping, DNS, TLS-Zertifikate, Datenbanken und mehr.
- Push-Monitore: Cronjobs und Backup-Skripte melden sich selbst. Bleibt die Meldung aus, gibt es einen Alarm.
- Benachrichtigungen: E-Mail, Telegram, Slack, Microsoft Teams, Webhooks und viele weitere Dienste.
- Statusseiten: öffentliche Seiten, auf denen Ihre Kunden den Zustand Ihrer Dienste sehen.
Uptime Kuma ist Open Source (MIT-Lizenz) und speichert alles in einer SQLite-Datenbank.
Warum ein eigener Seed?
Läuft Uptime Kuma auf demselben Server wie Ihre Website, fällt es mit ihr aus und kann nicht mehr warnen. Betreiben Sie es deshalb auf einem eigenen Seed, getrennt von den Systemen, die es überwacht. Einen Überblick über Monitoring auf der dataforest cloud gibt unsere Monitoring-Lösung.
Voraussetzungen
- Ein Seed mit IPv4-Adresse. Für den Einstieg reicht das kleinste Modell mit 1 vCPU und 2 GB RAM. Bei der One-Click-App bucht die Konsole die IPv4-Adresse automatisch dazu.
- SSH-Zugriff auf den Seed
- Optional eine eigene Domain (z.B.
status.ihre-firma.de), deren A-Record auf die IPv4-Adresse des Seeds zeigt. Ohne Domain erreichen Sie Uptime Kuma unter dem Hostnamen des Seeds.
Weg A: One-Click-App
1. Seed erstellen
Wählen Sie beim Erstellen des Seeds unter Anwendung die App Uptime Kuma. Zwei Einstellungen sind optional:
ADMIN_USERNAMElegt den Benutzernamen des Admin-Kontos fest, Standard istadmin.LETSENCRYPTsteht aufon, der Seed holt sich dann ein Zertifikat von Let's Encrypt. Mitoffnutzt er ein selbstsigniertes Zertifikat.
Das Passwort erzeugt der Seed selbst.
2. Zugangsdaten abrufen
Die Installation ist nach 1 bis 3 Minuten fertig. Verbinden Sie sich dann per SSH mit dem Seed:
cat /root/ready.txt
cat /root/uptime-kuma-credentials.txt
ready.txt nennt die Adresse von Uptime Kuma, die Zugangsdatei Benutzername und Passwort. Liegt stattdessen /root/failed.txt dort, steht darin der Grund. Die Ersteinrichtung ist bereits erledigt, niemand sonst kann unter der Adresse ein Admin-Konto anlegen.
3. Eigene Domain einrichten
Die Adresse erscheint in Benachrichtigungen und auf Ihren Statusseiten, deshalb lohnt sich eine eigene Domain von Anfang an. Sobald der A-Record auf den Seed zeigt, stellen Sie per SSH um:
seed-tls domain status.ihre-firma.de
Uptime Kuma bekommt ein Zertifikat von Let's Encrypt, und der bisherige Hostname leitet auf die Domain weiter.
Weiter geht es mit Erste Monitore anlegen.
Weg B: Installation per Docker Compose
Dieser Weg eignet sich, wenn Sie Uptime Kuma auf einem bestehenden Seed betreiben oder jede Einstellung selbst setzen möchten.
1. Docker installieren
curl -fsSL https://get.docker.com | sh
2. Verzeichnisse anlegen
mkdir -p /opt/uptime-kuma/data /opt/uptime-kuma/caddy && cd /opt/uptime-kuma
chown 1000:1000 data
Uptime Kuma läuft im Container nicht als root, sondern als Benutzer 1000. Deshalb gehört ihm das Datenverzeichnis.
3. Caddyfile erstellen
Caddy nimmt die HTTPS-Verbindungen an, holt automatisch ein Zertifikat von Let's Encrypt und reicht die Anfragen an Uptime Kuma weiter. Erstellen Sie die Datei caddy/Caddyfile:
status.ihre-firma.de {
reverse_proxy uptime-kuma:3001
}
4. compose.yaml erstellen
services:
uptime-kuma:
image: louislam/uptime-kuma:2.5.12-rootless
restart: always
environment:
TZ: Europe/Berlin
UPTIME_KUMA_DB_TYPE: sqlite
volumes:
- ./data:/app/data
caddy:
image: caddy:2-alpine
restart: always
ports:
- "80:80"
- "443:443"
volumes:
- ./caddy:/etc/caddy:ro
- caddy_data:/data
- caddy_config:/config
depends_on:
- uptime-kuma
volumes:
caddy_data:
caddy_config:
- Uptime Kuma ist nur über Caddy erreichbar, Port 3001 bleibt nach außen geschlossen.
UPTIME_KUMA_DB_TYPE: sqlitewählt die eingebaute Datenbank und überspringt die Datenbankauswahl beim ersten Aufruf../dataenthält die Datenbank und hochgeladene Dateien wie Logos von Statusseiten.
5. Starten und Admin-Konto anlegen
docker compose up -d
Nach etwa einer Minute ist Uptime Kuma erreichbar. Öffnen Sie dann sofort https://status.ihre-firma.de und legen Sie das Admin-Konto an. Bis dahin kann jede Person, die die Adresse kennt, dieses Konto für sich anlegen.
6. Einstellungen setzen
- Einstellungen > Reverse-Proxy: Stellen Sie Proxy vertrauen auf Ja. Sonst sieht Uptime Kuma statt der echten IP-Adressen nur die von Caddy.
- Einstellungen > Allgemein: Tragen Sie bei Primäre Basis-URL Ihre Adresse ein, etwa
https://status.ihre-firma.de. Uptime Kuma verlinkt sie in Benachrichtigungen.
Bei der One-Click-App sind beide Einstellungen schon gesetzt.
Erste Monitore anlegen
Klicken Sie auf Neuen Monitor hinzufügen und wählen Sie den Monitortyp. Für den Einstieg reichen drei:
- HTTP(s): prüft, ob eine URL antwortet. Im Abschnitt Erweitert schalten Sie Benachrichtigung bei Zertifikatsablauf ein, dann warnt Uptime Kuma rechtzeitig vor einem auslaufenden TLS-Zertifikat.
- HTTP(s) - Schlüsselwort: prüft zusätzlich, ob ein bestimmter Text auf der Seite steht. So fällt auch auf, wenn der Webserver nur eine Fehlerseite ausliefert.
- TCP Port: prüft, ob ein Dienst Verbindungen annimmt, etwa ein Mailserver oder eine Datenbank.
Standardmäßig prüft Uptime Kuma alle 60 Sekunden. Mit Wiederholungen legen Sie fest, wie viele Fehlschläge hintereinander einen Alarm auslösen. Ein bis zwei Wiederholungen vermeiden Fehlalarme durch kurze Aussetzer im Netz.
Cronjobs und Backups mit Push überwachen
Bei einem Push-Monitor fragt nicht Uptime Kuma, sondern Ihr Skript meldet sich. Legen Sie einen Monitor vom Typ Push an, kopieren Sie die angezeigte URL und rufen Sie sie am Ende Ihres Skripts auf:
curl -fsS -m 10 "https://status.ihre-firma.de/api/push/AbCdEf123?status=up&msg=OK"
Läuft das Skript nicht oder bricht es vorher ab, bleibt die Meldung aus, und Uptime Kuma schlägt Alarm. Setzen Sie das Intervall etwas länger als den Abstand zwischen zwei Läufen, bei einem täglichen Backup etwa auf 25 Stunden.
Benachrichtigungen einrichten
Öffnen Sie Einstellungen > Benachrichtigungen und klicken Sie auf Benachrichtigung einrichten. Wählen Sie den Dienst, etwa E-Mail (SMTP) oder Telegram, und prüfen Sie die Einstellung mit Testen. Zwei Optionen sparen Arbeit:
- Standardmäßig aktiviert hängt die Benachrichtigung an jeden neuen Monitor.
- Auf alle bestehenden Monitore anwenden ergänzt sie bei allen vorhandenen Monitoren.
Richten Sie für wichtige Dienste zwei Wege ein, etwa E-Mail und einen Messenger. Fällt einer aus, erreicht Sie die Warnung trotzdem.
Statusseite veröffentlichen
Auf einer Statusseite sehen Ihre Kunden, ob Ihre Dienste laufen, ohne beim Support nachfragen zu müssen.
- Öffnen Sie Statusseiten und klicken Sie auf Neue Statusseite.
- Vergeben Sie einen Namen und einen Slug, etwa
kunden. Die Seite ist dann unter/status/kundenerreichbar. - Legen Sie mit Gruppe hinzufügen Gruppen wie „Website“ oder „API“ an und ordnen Sie ihnen Monitore zu.
- Klicken Sie auf Speichern.
Die Statusseite ist öffentlich. Sie zeigt nur die Monitore, die Sie ihr zuordnen, mit ihrem Anzeigenamen, aber keine URLs oder Hostnamen.
Soll die Statusseite direkt unter Ihrer Domain erscheinen, wählen Sie sie unter Einstellungen > Allgemein als Einstiegsseite. Das Dashboard bleibt unter /dashboard erreichbar.
Bei Weg B kann die Statusseite auch eine eigene Domain bekommen, etwa status.ihre-firma.de neben uptime.ihre-firma.de für das Dashboard. Ergänzen Sie dafür in caddy/Caddyfile einen zweiten Block mit der Domain und reverse_proxy uptime-kuma:3001, laden Sie Caddy mit docker compose exec caddy caddy reload --config /etc/caddy/Caddyfile neu und tragen Sie die Domain bei der Statusseite unter Domainnamen ein.
Zugang absichern
Das Dashboard zeigt, welche Systeme Sie betreiben und wo sie erreichbar sind. Richten Sie deshalb unter Einstellungen > Sicherheit mit 2FA einrichten die Zwei-Faktor-Anmeldung ein. Dort ändern Sie unter Passwort ändern auch das Passwort, etwa wenn Sie das Konto mit anderen teilen.
Backup einrichten
Alle Monitore, Benachrichtigungen, Statusseiten und der Verlauf liegen in /opt/uptime-kuma/data/kuma.db. Ein konsistentes Backup im laufenden Betrieb erstellt sqlite3:
apt install -y sqlite3
mkdir -p /opt/backups
sqlite3 /opt/uptime-kuma/data/kuma.db ".backup '/opt/backups/kuma-$(date +%Y%m%d).db'"
Für ein tägliches Backup um 03:00 Uhr tragen Sie den Befehl mit crontab -e ein. In Cron muss jedes % als \% stehen:
0 3 * * * sqlite3 /opt/uptime-kuma/data/kuma.db ".backup '/opt/backups/kuma-$(date +\%Y\%m\%d).db'"
Ein Backup auf demselben Seed hilft nicht, wenn der Seed ausfällt. Kopieren Sie die Dateien deshalb regelmäßig auf ein anderes System oder buchen Sie die Offsite-Backups der dataforest cloud dazu.
Uptime Kuma aktualisieren
Lesen Sie vor einem Update die Release Notes und legen Sie einen Snapshot des Seeds an. Tragen Sie dann die neue Version ein, bei Weg B im Image der compose.yaml, bei der One-Click-App unter KUMA_IMAGE in /opt/uptime-kuma/.env, und führen Sie aus:
cd /opt/uptime-kuma
docker compose pull
docker compose up -d
Die Daten bleiben erhalten. Die installierte Version sehen Sie unter Einstellungen > Über.
Fehlerbehebung
Kein HTTPS-Zertifikat: Prüfen Sie mit dig +short status.ihre-firma.de, ob der A-Record auf den Seed zeigt. Details zeigen bei Weg B docker compose logs caddy, bei der One-Click-App seed-tls status.
Das Dashboard verbindet sich ständig neu: Uptime Kuma braucht eine WebSocket-Verbindung. Liegt vor Caddy ein weiterer Proxy oder eine Firewall, muss sie WebSocket-Verbindungen durchlassen.
Passwort vergessen:
cd /opt/uptime-kuma
docker compose exec uptime-kuma npm run reset-password
Fehlalarme: Erhöhen Sie die Wiederholungen und prüfen Sie, ob eine Firewall oder ein Bot-Schutz Anfragen vom Seed blockiert.
Zusammenfassung
Uptime Kuma läuft jetzt auf einem eigenen Seed, getrennt von den Systemen, die es überwacht. Es prüft Ihre Dienste rund um die Uhr, meldet Ausfälle und zeigt Ihren Kunden auf einer Statusseite, was gerade los ist. Für Einblicke in Auslastung von CPU, Speicher und Datenträgern ergänzt ein Checkmk-Monitoring-Server das Bild.
Mit einem Klick installieren
Der Seed führt die Installation beim ersten Start selbst aus.
