Uptime Kuma auf einem Managed VPS hosten: Ihre Dienste dauerhaft überwachen

Was Uptime Kuma überwacht

Uptime Kuma fragt Ihre Dienste in regelmäßigen Abständen ab, bis hinunter zu 20 Sekunden, bewahrt den Verlauf ihrer Antworten auf und benachrichtigt Sie, sobald einer nicht mehr antwortet. Bedient wird es über eine Weboberfläche, die in mehreren Sprachen verfügbar ist.

• Die Monitore: HTTP und HTTPS, Suche nach einem Schlüsselwort auf der Seite, JSON-Abfrage, TCP, WebSocket, Ping, DNS-Eintrag, Docker-Container und ein „Push“-Monitor für eine geplante Aufgabe, die selbst meldet, dass sie gelaufen ist.
• Die Benachrichtigungen: mehr als 90 Benachrichtigungsdienste, darunter Telegram, Discord, Slack und E-Mail.
• Die Statusseiten: mehrere öffentliche Seiten, auf Wunsch jede unter ihrer eigenen Domain.
• Die Zertifikate: die Angaben zum HTTPS-Zertifikat jedes überwachten Dienstes.
• Das Konto: Zwei-Faktor-Authentifizierung und die Nutzung eines Proxys für Monitore, die ihn brauchen.

Stellen Sie Uptime Kuma auf einen anderen Server als die Dienste, die es überwacht. Auf einer getrennten Maschine sieht es den Ausfall von außen und sendet den Alarm, während Ihre Dienste stillstehen.

Was die MIT-Lizenz erlaubt

Uptime Kuma wird unter der MIT-Lizenz veröffentlicht. Sie erlaubt, die Software zu nutzen, zu kopieren, zu ändern, zusammenzuführen, zu veröffentlichen, zu verbreiten, unterzulizenzieren und zu verkaufen, unter einer Bedingung: der Copyright-Hinweis und der Lizenztext bleiben in jeder Kopie erhalten.

Sie können Uptime Kuma also im Unternehmen betreiben, damit die Dienste Ihrer Kunden überwachen und für sie Statusseiten einrichten, ohne eine Lizenz zu kaufen.

Die Installation mit Docker Compose

Die Dokumentation von Uptime Kuma beginnt mit Docker Compose. Legen Sie auf einem Server, auf dem Docker installiert ist, einen Ordner an und laden Sie die offizielle Datei herunter:

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

Die Datei des Projekts veröffentlicht den Port 3001 auf allen Adressen des Servers. Hinter einem Reverse Proxy beschränken Sie ihn auf die lokale Adresse, wie es das README vorschlägt:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

• Ein auf 127.0.0.1 veröffentlichter Port: Docker veröffentlicht standardmäßig auf allen Adressen des Servers, noch vor den Regeln der Firewall ufw. Lokal gebunden, ist Uptime Kuma nur über den Reverse Proxy erreichbar.
• Ein Ordner data auf einer lokalen Festplatte: Er enthält die Datenbank kuma.db, hochgeladene Dateien und Screenshots. Das Projekt schließt NFS und andere Netzwerkdateisysteme aus, weil SQLite zuverlässige Dateisperren braucht.
• Das Tag 2 folgt der Version 2 von Uptime Kuma, und der Wechsel auf eine spätere Hauptversion bleibt Ihre Entscheidung.
• Das Image 2-slim ist schlanker, etwa 185 MB Download gegenüber 620 MB: Es verzichtet auf Chromium und das integrierte MariaDB, die das Image 2 mitbringt. Das Image 2 ist das vom Projekt empfohlene, und ein „Browser Engine“-Monitor braucht mit 2-slim ein externes Chromium.

Öffnen Sie beim ersten Start die Oberfläche: Ein Assistent lässt Sie die Datenbank wählen und dann das Administratorkonto anlegen. Aktivieren Sie die Zwei-Faktor-Authentifizierung gleich bei der ersten Anmeldung.

Das Projekt nennt weder Arbeitsspeicher noch Prozessor: Die Größe hängt von der Zahl der überwachten Dienste und der gewünschten Abfragehäufigkeit ab. Auf einem Managed VPS beschreiben Sie uns Ihren Einsatz, und wir empfehlen Ihnen die passende Größe.

HTTPS und WebSocket: der Reverse Proxy

In einem öffentlichen Netz verlangt das Projekt HTTPS. Uptime Kuma beruht auf WebSocket: Der Reverse Proxy muss die Header Upgrade und Connection weitergeben. Es wird im Stammverzeichnis einer Domain oder Subdomain ausgeliefert, und sein Wiki schließt Unterordner wie example.com/uptimekuma aus.

Mit Caddy

Caddy bezieht und erneuert das Zertifikat selbstständig und leitet WebSocket ohne weitere Einstellung durch:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Mit Nginx und Certbot

server {
    listen 80;
    server_name uptime.example.com;

    location / {
        proxy_pass         http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;
    }
}

Certbot richtet anschließend das Zertifikat von Let’s Encrypt und die Weiterleitung auf HTTPS ein und erneuert das Zertifikat danach selbstständig:

sudo certbot --nginx -d uptime.example.com

Ist Uptime Kuma nur über den Proxy erreichbar, öffnen Sie seine Einstellungen, „Settings“, „Reverse Proxy“, „HTTP Headers“, und stellen „Trust Proxy“ auf „Yes“: Die Protokolle zeigen dann die echte Adresse der Besucher.

SQLite oder MariaDB

Seit Version 2 bietet Uptime Kuma drei Datenbanken an, die Sie im Assistenten beim ersten Start wählen:

Um die Wahl im Voraus festzulegen, ohne den Assistenten, ergänzen Sie den Dienst in compose.yaml um die Variablen UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME und UPTIME_KUMA_DB_PASSWORD.

Die Benachrichtigungen, E-Mail inklusive

Ein Monitor nützt nur, wenn der Alarm Sie erreicht. Richten Sie Ihre Kanäle unter „Settings“, „Notifications“ ein, senden Sie von jedem eine Testnachricht und planen Sie zwei ein, zum Beispiel einen Messenger und E-Mail: Fällt der eine aus, springt der andere ein.

Für E-Mail verbindet sich Uptime Kuma mit einem SMTP-Server. Auf einem Simafri-VPS läuft der Versand über ein authentifiziertes Relay auf Port 587: die Adresse eines Postfachs, das Sie bereits haben, oder Simafri Suite.

Backups und Updates

Seit Version 2 ist die Sicherung des Ordners data die einzige Methode, die das Projekt unterstützt. Mit SQLite oder dem integrierten MariaDB steckt dort alles drin. Eine SQLite-Datenbank, die mitten im Schreiben kopiert wird, kann beschädigt werden: Stoppen Sie den Container für die Dauer der Kopie und bedenken Sie, dass die Monitore mit ihm anhalten.

docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start

Aktualisieren

Das Wiki des Projekts nennt zwei Befehle, auszuführen im Ordner der compose.yaml. Der Ordner data bleibt dabei erhalten:

docker compose pull
docker compose up -d --force-recreate

Lesen Sie vor jedem Update die Release Notes: Manche enthalten Sicherheitskorrekturen, wie die Version 2.5.9 vom 31. Oktober 2026. Ein Backup unmittelbar davor gibt Ihnen einen einfachen Weg zurück.

Der Wechsel von Version 1 auf Version 2 verlangt mehr Sorgfalt: Sichern Sie den Ordner data bei gestopptem Container und lassen Sie die Migration bis zum Ende laufen, denn nach einer unterbrochenen Migration müssen Sie das Backup wiederherstellen. Das Projekt hat etwa 7 Minuten für 20 Monitore und 90 Tage Verlauf gemessen, auf einer bescheidenen Maschine oder mit mehr Monitoren deutlich mehr.

Wer was tut auf einem Managed VPS

Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Uptime Kuma bleibt Ihre Software, mit ihren Einstellungen und Daten.

Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.