Zum Inhalt springen
Monitoring

Uptime Kuma für Erreichbarkeits-Monitoring einrichten

Schritt-für-Schritt-Anleitung, um Uptime Kuma auf einem dataforest Seed einzurichten, Websites und Dienste zu überwachen, Benachrichtigungen zu verschicken und eine öffentliche Statusseite zu veröffentlichen.

Getestet mit Uptime Kuma 2.5.12

ThemenUptime Kuma · Monitoring · Statusseite · Docker · Caddy
Level Einfach
Lesezeit9 Min.
Wörter1.500
AutorLaurenz Seipel
Veröffentlicht am12. November 2026

Mit einem Klick installieren

Die Installationsschritte aus dieser Anleitung führt der Seed beim ersten Start selbst aus. Einige Minuten nach dem Erstellen ist die Software einsatzbereit.

Details zu Uptime Kuma

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_USERNAME legt den Benutzernamen des Admin-Kontos fest, Standard ist admin.
  • LETSENCRYPT steht auf on, der Seed holt sich dann ein Zertifikat von Let's Encrypt. Mit off nutzt 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:

bash
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:

bash
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

bash
curl -fsSL https://get.docker.com | sh

2. Verzeichnisse anlegen

bash
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:

text
status.ihre-firma.de {
    reverse_proxy uptime-kuma:3001
}

4. compose.yaml erstellen

yaml
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: sqlite wählt die eingebaute Datenbank und überspringt die Datenbankauswahl beim ersten Aufruf.
  • ./data enthält die Datenbank und hochgeladene Dateien wie Logos von Statusseiten.

5. Starten und Admin-Konto anlegen

bash
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:

bash
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.

  1. Öffnen Sie Statusseiten und klicken Sie auf Neue Statusseite.
  2. Vergeben Sie einen Namen und einen Slug, etwa kunden. Die Seite ist dann unter /status/kunden erreichbar.
  3. Legen Sie mit Gruppe hinzufügen Gruppen wie „Website“ oder „API“ an und ordnen Sie ihnen Monitore zu.
  4. 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:

bash
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:

text
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:

bash
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:

bash
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.

Bereit loszulegen?

Erstellen Sie Ihren ersten Seed und starten Sie in wenigen Minuten.