Mit Uptime Kuma Docker Compose richtest du einen eigenen Verfügbarkeitsmonitor in wenigen Schritten ein. Die offizielle Compose-Datei startet die Weboberfläche auf Port 3001 und speichert alle Daten unter /app/data. Wichtig sind lokaler Speicher, ein bewusst begrenzter Zugriff und ein überprüfbarer Update-Ablauf.
Stand: 01.11.2026
Auf einen Blick
- Die offizielle Compose-Datei verwendet
louislam/uptime-kuma:2,restart: unless-stoppedund den Datenpfad./data:/app/data. - Der Dienst lauscht nach der Standardkonfiguration auf Port 3001 an allen Netzwerkschnittstellen.
- NFS ist für das Uptime-Kuma-Datenverzeichnis nicht unterstützt; verwende lokalen Speicher oder ein lokales Docker-Volume.
- Ein HTTP-Monitor prüft einen definierten Endpunkt, ersetzt aber keinen vollständigen Funktions- oder Metriktest.
- Aktualisiere Compose-Installationen mit
docker compose pullunddocker compose up -d --force-recreate.
Was ist Uptime Kuma und wann lohnt es sich?
Uptime Kuma ist ein selbst gehostetes Werkzeug für die Erreichbarkeitsüberwachung. Es unterstützt laut Projekt unter anderem HTTP(S), TCP, HTTP-Schlüsselwort- und JSON-Abfragen, WebSocket, Ping, DNS, Push-Monitore und Docker-Container. Zusätzlich stehen Statusseiten, Zertifikatsinformationen, Zwei-Faktor-Authentifizierung und zahlreiche Benachrichtigungsdienste zur Verfügung.
Damit passt das Tool gut zu Websites, Reverse Proxys, NAS-Diensten und Anwendungen im Heimnetz. Für jedes wichtige Ziel definierst du bewusst, was „erreichbar“ bedeutet. Eine Antwort mit Status 200 kann genügen, bei einer Anwendung mit Anmeldung oder Datenbank brauchst du jedoch oft einen spezifischeren Prüfpfad.
Uptime Kuma sammelt keine vollständigen Infrastrukturmetriken wie Prometheus. Wenn du Auslastung, Zeitreihen und Dashboards für Kubernetes brauchst, ergänzt du es daher sinnvoll mit Kubernetes Monitoring mit Grafana und Prometheus. Uptime Kuma bleibt dabei die gut verständliche Sicht auf Verfügbarkeit und Alarmierung.
Welche Voraussetzungen braucht Uptime Kuma Docker Compose?
Du brauchst einen Host mit Docker Engine und dem Docker-Compose-Plugin. Prüfe vor der Installation den Speicherort für die Compose-Datei und die Anwendungsdaten. Lege beides in einem Ordner ab, den du sichern und eindeutig zuordnen kannst.
Das Uptime-Kuma-Projekt warnt ausdrücklich vor NFS für den Datenpfad. Verwende deshalb einen lokalen Datenträger oder ein lokales Docker-Volume. So liegen Konfiguration, Monitore und Verlauf nicht im flüchtigen Container-Dateisystem und werden beim Ersetzen des Containers wieder eingebunden.
Wenn du Compose noch nicht verwendest, erklärt Docker Compose Grundlagen die Struktur einer Compose-Datei. Plane außerdem vorab, wer die Verwaltungsoberfläche erreichen darf. Ein Monitoring-Dashboard enthält oft interne URLs und Zustandsdaten.
Uptime Kuma Docker Compose einrichten: Welche Datei verwendest du?
Erstelle einen eigenen Ordner und speichere darin eine Datei namens compose.yaml. Die folgende Konfiguration entspricht der aktuellen offiziellen Compose-Datei des Projekts. Der Tag :2 folgt der Hauptversion; am 01.11.2026 ist 2.5.9 das aktuelle stabile GitHub-Release.
services:
uptime-kuma:
image: louislam/uptime-kuma:2
restart: unless-stopped
volumes:
- ./data:/app/data
ports:
- "3001:3001"Starte den Dienst anschließend im selben Verzeichnis:
- Lege den Projektordner an und wechsle hinein.
- Speichere die gezeigte Konfiguration als
compose.yaml. - Ziehe das Image und starte den Dienst im Hintergrund.
- Öffne die Ersteinrichtung im Browser und erstelle das Administratorkonto.
- Lege erst danach die wichtigen Monitore und mindestens einen Alarmkanal an.
mkdir -p ~/uptime-kuma
cd ~/uptime-kuma
docker compose pull
docker compose up -dDanach ist die Oberfläche standardmäßig unter http://HOSTNAME-ODER-IP:3001 erreichbar. Die Portzuordnung 3001:3001 veröffentlicht den Dienst auf den Netzwerkschnittstellen des Hosts. Beschränke den Zugriff per Firewall, privatem Netz oder Reverse Proxy, wenn die Oberfläche nicht allgemein erreichbar sein soll.
Warum ist der Datenpfad entscheidend?
Die Zeile ./data:/app/data bindet einen lokalen Ordner neben der Compose-Datei in den Container ein. Uptime Kuma speichert dort seine Anwendungsdaten. Ohne diesen Mount verlierst du beim Ersetzen des Containers den gespeicherten Zustand.
| Eintrag | Wirkung | Worauf du achtest |
|---|---|---|
image | Wählt das Uptime-Kuma-Container-Image. | :2 bleibt innerhalb der unterstützten Hauptversion aktuell. |
restart | Startet den Container nach einem Docker- oder Host-Neustart erneut. | Ein bewusst gestoppter Container bleibt mit unless-stopped gestoppt. |
volumes | Hält Daten außerhalb des Containers. | Lokalen und gesicherten Speicher statt NFS verwenden. |
ports | Veröffentlicht die Weboberfläche am Host. | Port 3001 nur für die nötigen Netze freigeben. |
Ein relativer Pfad wie ./data bezieht sich beim lokalen Compose-Aufruf auf den Projektordner. Das ist praktisch, weil Compose-Datei und Sicherungsziel zusammenbleiben. Prüfe nach dem ersten Start trotzdem, ob der Ordner wirklich angelegt wurde und Docker ihn beschreiben kann.
Wie legst du den ersten Monitor sinnvoll an?
Melde dich an und wähle in der Oberfläche „Monitor hinzufügen“. Für eine Website ist HTTP(S) der naheliegende Start. Setze eine konkrete URL, die tatsächlich die gewünschte Anwendung repräsentiert, und wähle ein Intervall, das zu deiner Reaktionszeit passt.
- Wähle den Monitortyp, etwa HTTP(S), TCP, Ping oder DNS.
- Trage URL, Host oder den gewünschten DNS-Eintrag ein.
- Lege bei HTTP eine erwartete Antwort fest, wenn der Standardstatus nicht genügt.
- Speichere den Monitor und beobachte die ersten Prüfergebnisse.
- Richte eine Benachrichtigung ein und teste sie kontrolliert.
Beginne mit wenigen Diensten, für die du bei einer Störung auch handeln kannst: Reverse Proxy, zentrale Anwendung und Backup-Ziel sind typische Kandidaten. Anschließend ergänzt du Abhängigkeiten. So vermeidest du eine Flut gleichartiger Alarme, wenn nur eine gemeinsame Netzwerkverbindung ausgefallen ist.
Wie sicherst du den Zugriff auf die Weboberfläche?
Für reinen Zugriff im LAN kann die Portfreigabe ausreichen. Möchtest du einen Namen und HTTPS nutzen, setze einen Reverse Proxy davor und veröffentliche nicht automatisch Port 3001 ins Internet. Die Grundlagen dafür zeigt Traefik im Homelab mit Docker Compose.
Aktiviere außerdem ein starkes Administratorkonto und die verfügbare Zwei-Faktor-Authentifizierung. Trenne externe Erreichbarkeit von der Fähigkeit, interne Ziele zu überwachen: Uptime Kuma kann private Namen und Adressen prüfen, ohne dass seine Verwaltungsoberfläche öffentlich sein muss.
Wie aktualisierst du Uptime Kuma zuverlässig?
Prüfe vor einem Update die offizielle Update-Anleitung und sichere den Datenordner. Für eine Compose-Installation nennt das Projekt diese Befehle:
cd ~/uptime-kuma
docker compose pull
docker compose up -d --force-recreateKontrolliere danach in der Weboberfläche, ob die Monitore wieder laufen und eine Testbenachrichtigung ankommt. Das aktuelle Release 2.5.9 enthält unter anderem einen Sicherheitsfix für RSS-Cache-Poisoning. Deshalb solltest du Updates nicht nur ziehen, sondern das erfolgreiche Neuanlegen des Containers und die Funktion der Überwachung nachvollziehen.
Sichere mindestens den Ordner data zusammen mit der Compose-Datei. Ein Backup ist erst belastbar, wenn du den Wiederherstellungsweg kennst. Für Docker-Daten und Volumes hilft auch die Anleitung Restic Docker Backup beim Einordnen einer regelmäßigen Sicherung.
Welche Fehler sind bei Uptime Kuma Docker Compose häufig?
Die Oberfläche ist nicht erreichbar. Prüfe zuerst docker compose ps, die Portzuordnung und die Host-Firewall. Vergleiche dann die verwendete Host-Adresse mit dem Netz, aus dem du zugreifst. Ein laufender Container bedeutet nicht automatisch, dass der veröffentlichte Port erreichbar ist.
Monitore fehlen nach einem Neustart. Prüfe, ob ./data:/app/data in genau der verwendeten Compose-Datei steht und ob du den Dienst aus dem richtigen Ordner startest. Fehlt der persistente Pfad, startet der neue Container ohne die bisherigen Daten.
Der Datenordner liegt auf NFS. Verschiebe die Daten auf lokalen Speicher oder nutze ein lokales Docker-Volume. Das Projekt unterstützt NFS für diesen Pfad nicht; verlasse dich daher nicht auf eine Konfiguration, die nur scheinbar funktioniert.
Es kommen keine Alarme an. Prüfe den gewählten Benachrichtigungsdienst mit einem Test und kontrolliere Zieladresse, Zugangsdaten sowie eventuelle Filter. Erst ein getesteter Alarmkanal macht einen Monitor im Störungsfall nützlich.
Fazit
Uptime Kuma Docker Compose ist ein klarer Einstieg in selbst gehostete Verfügbarkeitsüberwachung. Übernimm die offizielle Compose-Datei, speichere Daten lokal, begrenze den Zugriff auf die Oberfläche und teste jeden Alarmweg. Mit regelmäßigen Updates und einem gesicherten Datenordner bleibt die Installation nachvollziehbar und wiederherstellbar.
Quellen
- Uptime Kuma: offizielles Repository und Installationshinweise
- Uptime Kuma: offizielle compose.yaml
- Uptime Kuma 2.5.9: Release Notes
- Uptime Kuma: offizielle Update-Anleitung
Häufige Fragen
Lege die offizielle compose.yaml in einem eigenen Ordner ab und starte sie dort mit docker compose up -d. Anschließend öffnest du die Oberfläche über Port 3001 und erstellst das Administratorkonto.
Die offizielle Compose-Datei ordnet Container-Port 3001 dem Host-Port 3001 zu. Damit lauscht die Oberfläche standardmäßig auf http://HOSTNAME-ODER-IP:3001.
Im offiziellen Compose-Beispiel wird ./data auf dem Host nach /app/data im Container gemountet. Dieser persistente Pfad bewahrt die Konfiguration beim Ersetzen des Containers.
Nein. Das Uptime-Kuma-Projekt nennt NFS für den Datenpfad als nicht unterstützt. Verwende lokalen Speicher oder ein lokales Docker-Volume.
Wechsle in den Compose-Ordner, führe docker compose pull aus und erstelle den Dienst mit docker compose up -d –force-recreate neu. Prüfe danach Monitore und Alarmkanal.





1 Pingback