Uptime Kuma einrichten: Docker-Anleitung für Version 2
Uptime Kuma 2 mit Docker Compose auf dem VPS einrichten: Monitore, Statusseite, Caddy-Reverse-Proxy und MariaDB. Schritt für Schritt erklärt.
Auf YouTube ansehen
Inhalt
Uptime Kuma 2.5.9Docker 29.9Ubuntu 24.04Was ist Uptime Kuma?
Uptime Kuma ist ein beliebtes, selbst gehostetes Monitoring-Tool. mit dem ihr eure Webseiten, Server und eigentlich fast jeden Onlinedienst überwachen könnt. Es ist übersichtlich gestaltet und bietet vielfältige Benachrichtigungsoptionen. So erfahrt ihr immer als Erstes, wenn eure Seite oder euer Dienst nicht mehr funktioniert. Es zeichnet sich durch eine moderne und reaktive Benutzeroberfläche aus und bietet eine breite Palette an Überwachungsfunktionen:
- HTTP(s) / TCP / HTTP(s) Keyword / HTTP(s) Json Query
- Ping / DNS Record / Push
- Steam Game Server / Docker Container
- Benachrichtigungen über 90+ Dienste (Telegram, Discord, E-Mail etc.)
- Kurze Überwachungsintervalle (bis zu 20 Sekunden)
- Mehrsprachigkeit
- Erstellung mehrerer Statusseiten, auch mit Zuordnung zu eigenen Domains
- Zertifikatsinformationen und Ping-Charts
- Proxy- und 2FA-Unterstützung
Das Beste daran: Es ist Open Source und ihr behaltet die volle Kontrolle über eure Daten.
Voraussetzungen
- Ein VPS (z.B. mit Ubuntu 24.04 oder einer anderen Linux-Distribution).
- Docker und Docker Compose müssen auf dem Server installiert sein.
- Grundlegende Kenntnisse im Umgang mit der Kommandozeile.
- (Optional) Eine Domain, wenn du Uptime Kuma später über einen Reverse Proxy mit einer eigenen Adresse erreichbar machen möchtest.
Installation mit Docker Compose
Wir werden Uptime Kuma mithilfe von Docker Compose installieren. Dies ermöglicht uns eine flexible Konfiguration, insbesondere wenn wir später eine separate Datenbank oder einen Reverse Proxy hinzufügen möchten.
-
Verbindung zum Server und Verzeichnis erstellen Verbinde dich per SSH mit deinem VPS. Erstelle dann ein Verzeichnis für Uptime Kuma und wechsle hinein, darin erstellen wir auch ein Unterverzeichnis für die Daten:
Terminalbashmkdir uptime-kuma cd uptime-kuma mkdir data -
Docker Compose Datei erstellen Erstelle eine
compose.yaml-Datei mit einem Texteditor deiner Wahl (z.B.nano):Terminalbashnano compose.yamlFüge folgenden Inhalt ein. Dieser Basis-Setup startet Uptime Kuma mit einer integrierten SQLite-Datenbank, was für viele Anwendungsfälle ausreichend ist.
yamlservices: uptime-kuma: image: louislam/uptime-kuma:2 container_name: uptime-kuma volumes: - ./data:/app/data ports: - "3001:3001" # <Host-Port>:<Container-Port> restart: alwaysimage: louislam/uptime-kuma:2: Dies ist das offizielle Image von Docker Hub und folgt der stabilen Version 2.container_name: uptime-kuma: Ein benutzerdefinierter Name für unseren Container.volumes: ./data:/app/data: Sehr wichtig! Hiermit legen wir fest, dass die Daten von Uptime Kuma (Konfiguration, Checks, etc.) im Unterordnerdataauf unserem Host gespeichert werden. So bleiben die Daten auch erhalten, wenn wir den Container neu starten oder aktualisieren.ports: "3001:3001": Uptime Kuma läuft im Container auf Port 3001. Wir mappen diesen auf den Port 3001 unseres VPS. Wenn Port 3001 bei dir schon belegt ist, kannst du den Host-Port ändern (z.B."3002:3001").restart: always: Stellt sicher, dass der Container automatisch neu startet, falls der Server mal neu gestartet wird oder der Container abstürzt.
Speichere die Datei (bei
nanomitStrg+O, Enter, dannStrg+X). -
Uptime Kuma starten Da wir uns im Verzeichnis mit der
compose.yaml-Datei befinden, können wir die Container einfach starten:Terminalbashsudo docker compose up -dDocker wird nun das Uptime Kuma Image herunterladen (das kann beim ersten Mal einen Moment dauern) und den Container im Hintergrund starten (
-dfür detached mode).Du kannst den Status der Container überprüfen:
Terminalbashsudo docker compose psUnd die Logs einsehen:
Terminalbashsudo docker compose logs uptime-kumaUm den Ressourcenverbrauch zu sehen:
Terminalbashsudo docker compose stats
Ersteinrichtung von Uptime Kuma
Öffne nun deinen Webbrowser und gib die IP-Adresse deines Servers gefolgt von Port 3001 ein: http://DEINE_SERVER_IP:3001.
Du wirst vom Einrichtungsassistenten begrüßt:
-
Sprache und Datenbank auswählen: Wähle deine bevorzugte Sprache und den Datenbank-Typ. Zur Auswahl stehen eine eingebettete MariaDB (im Image enthalten, ohne weitere Einstellungen), SQLite (eine einfache Datei, für kleine Installationen) und eine externe MariaDB/MySQL. Für diese Anleitung reicht SQLite oder die eingebettete MariaDB. Die externe Datenbank richten wir weiter unten ein. Klicke danach auf “Weiter”.

-
Benutzerkonto erstellen: Lege einen Administrator-Benutzernamen und ein sicheres Passwort fest.
Klicke auf “Erstellen” und du landest im Dashboard von Uptime Kuma.
Uptime Kuma erkunden und konfigurieren
Dashboard
Das Dashboard ist deine zentrale Anlaufstelle. Hier siehst du alle deine Monitore und deren aktuellen Status.
Einstellungen (Settings)
Klicke oben rechts auf dein Profilbild und dann auf “Einstellungen”. Hier einige wichtige Punkte:
- Allgemein (General):
- Angezeigte Zeitzone (Display Timezone): Stelle deine lokale Zeitzone ein.
- Primäre Basis-URL (Primary Base URL): Wichtig, wenn du später einen Reverse Proxy nutzt.
- Suchmaschinen-Sichtbarkeit (Search Engine Visibility): Verhindere, dass deine Uptime Kuma Instanz von Google indexiert wird.
- Darstellung (Appearance): Wähle zwischen hellem, dunklem oder automatischem Theme.
- Benachrichtigungen (Notifications): Das Herzstück! Richte hier deine Benachrichtigungskanäle ein.
- Klicke auf “Benachrichtigung einrichten”.
- Wähle den Typ (z.B. E-Mail (SMTP), Telegram, Discord).
- Gib die erforderlichen Daten ein. Für SMTP benötigst du die Daten deines Mailservers oder eines Dienstes wie Maileroo Affiliate Link.
- Du kannst Testbenachrichtigungen senden.
- Über (About):
- Hier kannst du nach Updates suchen. Wenn du auch Beta-Versionen sehen möchtest, setze den Haken bei “Auch Beta-Versionen prüfen”.
Einen Monitor hinzufügen
Gehe zurück zum Dashboard und klicke auf “Neuen Monitor hinzufügen”.
- Monitortyp: Wähle den passenden Typ aus. Für eine Webseite ist “HTTP(s)” üblich.
- Anzeigename: Ein beschreibender Name, z.B. “Meine Webseite”.
- URL: Die vollständige URL, z.B.
https://deployn.de. - Heartbeat-Intervall: Wie oft geprüft werden soll (z.B. alle 60 Sekunden).
- Wiederholungen: Wie oft ein Fehler auftreten muss, bevor der Dienst als “Down” markiert wird.
- Benachrichtigungen: Rechts neben den allgemeinen Einstellungen wählst du deine zuvor eingerichteten Benachrichtigungskanäle aus, die für diesen Monitor zuständig sein sollen.
- Weitere Einstellungen: Du kannst z.B. erwartete HTTP-Statuscodes (“Akzeptierte Statuscodes”) festlegen oder mit dem Monitortyp “HTTP(s) - Schlüsselwort” nach Keywords im Seiteninhalt suchen.
Klicke auf “Speichern”. Dein Monitor erscheint nun im Dashboard und wird regelmäßig geprüft.

Eine Statusseite erstellen
Mit Uptime Kuma kannst du öffentliche oder private Statusseiten erstellen, um den Zustand deiner Dienste anzuzeigen.
- Klicke im Menü auf “Statusseiten”.
- Klicke auf “Neue Statusseite”.
- Name: z.B. “Deployn Status”.
- Slug: Ein URL-freundlicher Name, z.B.
deployn-status. - Klicke auf “Weiter”. Es öffnet sich direkt der Editor der Statusseite.
- Wähle im Feld “Monitor hinzufügen” die Monitore aus, die auf dieser Statusseite angezeigt werden sollen.
- Klicke unten links auf “Speichern”.
Du erhältst einen Link zu deiner Statusseite (z.B. http://DEINE_SERVER_IP:3001/status/deployn-status). Diese kannst du teilen, um Nutzern Transparenz über deine Systemverfügbarkeit zu geben.

Erweiterung: Externe MariaDB-Datenbank (Optional)
Wenn du eine robustere Datenbanklösung bevorzugst oder bereits MariaDB nutzt, kannst du Uptime Kuma mit einer separaten MariaDB-Instanz verbinden.
-
Docker Compose anpassen: Stoppe zuerst deine laufenden Uptime Kuma Container und erstelle einen neuen Ordner für die MariaDB-Daten:
Terminalbashsudo docker compose down mkdir mariadb-dataÖffne deine
compose.yamlund erweitere sie:yamlservices: uptime-kuma: image: louislam/uptime-kuma:2 container_name: uptime-kuma volumes: - ./data:/app/data ports: - 3001:3001 restart: always networks: - internal # Für interne Kommunikation depends_on: - uptime-kuma-db uptime-kuma-db: image: mariadb:11 container_name: uptime-kuma-db restart: always networks: - internal volumes: - ./mariadb-data:/var/lib/mysql # Wichtig für Datenpersistenz der DB! environment: - MARIADB_ROOT_PASSWORD=uptimekumapassword # Root-Passwort für die DB - MARIADB_DATABASE=uptimekuma - MARIADB_USER=uptimekuma - MARIADB_PASSWORD=password networks: internal: external: falseWichtige Änderungen:
- Wir haben einen neuen Service
uptime-kuma-dbfür MariaDB hinzugefügt. - Passwörter und Namen anpassen!
- Für
uptime-kuma-dbwird das Volume./mariadb-data:/var/lib/mysqlgemappt, um die Datenbankdaten persistent zu speichern. - Ein
internalNetzwerk wurde für die Kommunikation zwischen den Containern definiert.
- Wir haben einen neuen Service
-
Container neu starten:
Terminalbashsudo docker compose up -dWenn du Uptime Kuma zum ersten Mal mit dieser Konfiguration startest und die
./dataleer ist, wirst du wieder durch den Setup-Prozess geführt. Wähle dann “Externe MariaDB/MySQL” aus und trage die Daten ein: Hostuptime-kuma-db, Port3306, Benutzer, Passwort und Datenbankname wie in der Compose-Datei.
Erweiterung: Reverse Proxy mit Caddy (Optional)
Um Uptime Kuma über eine eigene Domain (z.B. status.deine-domain.de) mit HTTPS zu erreichen, ist ein Reverse Proxy ideal. Hier ein Beispiel mit Caddy.
-
Voraussetzung: Caddy ist bereits auf deinem Server installiert und läuft (z.B. auch als Docker Container). Du hast ein Docker-Netzwerk (hier
proxygenannt), das Caddy und Uptime Kuma gemeinsam nutzen können.Terminalbash# Falls noch nicht vorhanden, erstelle ein externes Docker-Netzwerk sudo docker network create proxy -
Caddyfile anpassen: Füge deiner Caddyfile (oder der entsprechenden Konfigurationsdatei) einen Eintrag für Uptime Kuma hinzu:
caddystatus.deine-domain.de { reverse_proxy uptime-kuma:3001 }status.deine-domain.de: Ersetze dies mit deiner gewünschten Domain/Subdomain. Stelle sicher, dass der DNS-Eintrag dafür auf die IP deines Servers zeigt.uptime-kuma:3001: Caddy leitet Anfragen an den Containeruptime-kumaauf Port3001weiter.
-
Uptime Kuma Docker Compose anpassen: Öffne erneut die
compose.yamlfür Uptime Kuma:- Stelle sicher, dass die
ports-Sektion für denuptime-kuma-Service auskommentiert oder entfernt ist, da Caddy den Zugriff übernimmt. - Füge den
uptime-kuma-Service dem Netzwerkproxyhinzu und deklariere es als extern:
yamlservices: uptime-kuma: # ... (andere Einstellungen) ... # ports: # Auskommentieren oder entfernen # - "3001:3001" networks: - internal - proxy # Hinzufügen # ... (Rest der Einstellungen) ... networks: internal: external: false proxy: # Hinzufügen external: true - Stelle sicher, dass die
-
Container neu starten und Caddy neuladen:
Terminalbashsudo docker compose up -d # Startet Uptime Kuma neu mit den Netzwerkänderungen sudo docker exec caddy caddy reload --config /etc/caddy/Caddyfile # Lädt die Caddy-Konfiguration neu (Container heißt hier caddy)Nun solltest du Uptime Kuma unter
https://status.deine-domain.deerreichen können. In den Uptime Kuma Einstellungen unter “Primäre Basis-URL” kannst du diese neue Adresse eintragen.
Erweiterung: Docker Container überwachen (Optional)
Uptime Kuma kann auch den Status anderer Docker Container auf demselben Host überwachen.
-
Docker Socket in Uptime Kuma einbinden: Passe die
compose.yamlfür denuptime-kuma-Service an, um den Docker Socket read-only einzubinden:yaml# ... (services -> uptime-kuma) ... volumes: - ./data:/app/data - /var/run/docker.sock:/var/run/docker.sock:ro # Hinzufügen # ... (Rest der Einstellungen) ...Achtung: Das Einbinden des Docker Sockets gibt dem Container potenziell weitreichende Kontrolle über Docker. Nutze dies mit Bedacht und verstehe die Sicherheitsimplikationen.
:ro(read-only) ist hier ein wichtiger erster Schritt. -
Container neu starten:
Terminalbashsudo docker compose up -d -
Docker Host in Uptime Kuma hinzufügen:
- Gehe in Uptime Kuma zu Einstellungen -> Docker-Hosts.
- Klicke “Docker-Host einrichten”.
- Anzeigename: z.B. “Lokaler Docker Host”.
- Verbindungstyp: Lass “Socket” ausgewählt.
- Docker-Daemon: Der Pfad
/var/run/docker.sockist bereits eingetragen. - Mit “Testen” prüfst du die Verbindung. Bei Erfolg erscheint die Meldung “Connected Successfully” samt Anzahl der Container. Klicke danach auf “Speichern”.
-
Docker Container Monitor erstellen:
- Gehe zum Dashboard und klicke “Neuen Monitor hinzufügen”.
- Monitortyp: “Docker-Container”.
- Docker-Host: Wähle den zuvor erstellten “Lokaler Docker Host”.
- Container-Name / ID: Gib den exakten Namen des Containers ein, den du überwachen möchtest (z.B.
caddyoderuptime-kuma-db). - Klicke “Speichern”.
Uptime Kuma zeigt nun den Status (Up/Down) des angegebenen Containers an.
Von Uptime Kuma 1 auf Version 2 aktualisieren
Läuft bei dir noch das Image louislam/uptime-kuma:1, sicherst du zuerst die Daten und stellst dann das Image um. Stoppe den Container und packe den Ordner data ein:
sudo docker compose down
tar czf uptime-kuma-backup.tgz dataPasse danach die compose.yaml an:
image: louislam/uptime-kuma:1
image: louislam/uptime-kuma:2Lade das neue Image und starte den Container:
sudo docker compose pull
sudo docker compose up -dBeim ersten Start migriert Uptime Kuma die Datenbank selbst. In den Logs (sudo docker compose logs uptime-kuma) siehst du dazu Zeilen mit [MIGRATION]. Ich habe den Ablauf mit einer frischen Version-1-Installation ohne Monitore getestet. Mit einer gewachsenen Installation habe ich ihn nicht durchgespielt, das Backup ist deshalb Pflicht.
Backups nicht vergessen!
Ein Monitoring-Tool ist nur so gut wie seine Verfügbarkeit und die Sicherheit seiner Daten. Denke daran, regelmäßige Backups deiner persistenten Daten zu erstellen:
- Der Ordner
./data(enthält die Konfiguration und SQLite-DB, falls verwendet). - Der Ordner
./mariadb-data(falls du eine externe MariaDB wie oben beschrieben nutzt).
Tools wie Duplicati (das du ebenfalls als Docker Container betreiben kannst) können dir dabei helfen, diese Ordner regelmäßig zu sichern, z.B. auf ein externes Laufwerk oder in die Cloud.
Fazit
Uptime Kuma ist mit Docker und Docker Compose wirklich schnell aufgesetzt und bietet eine tolle, moderne Möglichkeit, eure Dienste im Auge zu behalten. Die Flexibilität durch Docker Compose erlaubt es zudem, das Setup an die eigenen Bedürfnisse anzupassen, sei es durch eine externe Datenbank oder die Integration mit einem Reverse Proxy.
Ich hoffe, dieses Tutorial hat euch geholfen!
Änderungsprotokoll
Auf Uptime Kuma 2 umgestellt (Image :2), Einrichtungsassistent mit Datenbankauswahl und Menünamen angepasst, Screenshots ergänzt, Fehler in den Compose-Beispielen und im Caddy-Befehl behoben, Abschnitt zum Update von Version 1 ergänzt.