Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Uptime Kuma
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Uptime Kuma prüft in festen Abständen, ob Websites, Server und Dienste erreichbar sind, und meldet sich, sobald etwas ausfällt oder ein TLS-Zertifikat bald abläuft. Es beherrscht unter anderem Abfragen per HTTP(S) mit Suche nach einem Schlüsselwort, Ping, offene TCP-Ports und DNS-Einträge. Die Ergebnisse zeigt es als übersichtliches Dashboard mit Verfügbarkeit und Antwortzeiten und auf Wunsch als öffentliche Statusseite. Benachrichtigungen verschickt es über mehr als 90 Wege, etwa E-Mail, Telegram, Matrix oder ntfy. Während Zabbix oder Munin vor allem das Innere eines Rechners beobachten, schaut Uptime Kuma von außen auf die Dienste.
Hinweis: nicht selbst getestet. Diese Anleitung beruht auf der offiziellen Dokumentation von Uptime Kuma (README und Wiki, Stand 2. Oktober 2026). Selbst geprüft wurden nur das Herunterladen des Quellcodes von Version 2.5.5 und die Installation der Abhängigkeiten mit
npm ci(Schritte 7 und 8) mit Node.js 22.22 und npm 9.2 aus Ubuntu. Das Herunterladen der vorgebauten Oberfläche, der Start des Dienstes und die Bedienung im Browser wurden für dieses Buch nicht ausprobiert. Die Menünamen stammen aus der deutschen Sprachdatei des Programms. Befehle und Ausgaben können daher von der Beschreibung abweichen.
Vorbemerkungen
- Kein apt-Paket: Ubuntu 26.04 enthält Uptime Kuma nicht. Das Projekt bietet außer Docker nur die Installation aus dem Quellcode mit Node.js an. Node.js, npm und git kommen dabei aus den Ubuntu-Paketquellen. Uptime Kuma 2.5.5 braucht Node.js ab Version 20.4, Ubuntu liefert 22.22.
- Eigener Systembenutzer: Uptime Kuma läuft unter einem eigenen Benutzer
uptime-kumaohne Anmeldemöglichkeit. Programm und Daten liegen unter/opt/uptime-kuma, die Daten im Unterordnerdatain einer SQLite-Datenbank. - Nur lokal: Ohne Einstellung lauscht Uptime Kuma auf Port 3001 an allen Netzwerkschnittstellen. Der systemd-Dienst in Schritt 10 beschränkt das auf
127.0.0.1. - Eigenes Konto: Uptime Kuma hat eine eigene Benutzerverwaltung. Beim ersten Aufruf legst du das Administrator-Konto an. Bis dahin könnte jeder, der die Seite erreicht, das Konto anlegen. Auch deshalb bleibt sie auf
127.0.0.1. - Größe: Auf einem Rechner ohne npm zieht
npmaus Ubuntu viele kleinenode-*-Pakete nach (je nach Rechner über 100). Uptime Kuma selbst installiert rund 650 npm-Pakete in seinen eigenen Ordner. - Version: Uptime Kuma 2.5.5 vom 16. September 2026.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Node.js, npm und git installieren
sudo apt install nodejs npm git
Prüfen: Die Ausgabe beginnt mit v22.
/usr/bin/node --version
Hinweis: Die Anleitung ruft
nodeundnpmübersudoauf. Dabei gelten immer die Programme aus Ubuntu unter/usr/bin, auch wenn du für deinen Benutzer mitnvmeine andere Node.js-Version eingerichtet hast.
3. Systembenutzer anlegen
Legt den Benutzer uptime-kuma ohne Passwort und ohne Anmelde-Shell an. --system macht ihn zu einem Dienstkonto, --home-dir legt /opt/uptime-kuma als sein Heimatverzeichnis fest.
sudo useradd --system --home-dir /opt/uptime-kuma --shell /usr/sbin/nologin uptime-kuma
4. Programmordner anlegen
sudo mkdir /opt/uptime-kuma
5. Ordner dem Systembenutzer übergeben
So laufen alle weiteren Schritte unter uptime-kuma statt unter root. Die Installationsskripte der npm-Pakete bekommen dadurch keine Administratorrechte.
sudo chown uptime-kuma:uptime-kuma /opt/uptime-kuma
6. In den Programmordner wechseln
cd /opt/uptime-kuma
7. Quellcode herunterladen
Lädt genau die Version 2.5.5 von GitHub in den leeren Ordner. --depth 1 lässt die ältere Versionsgeschichte weg. -u uptime-kuma -H führt den Befehl als Systembenutzer mit dessen Heimatverzeichnis aus.
sudo -u uptime-kuma -H git clone --branch 2.5.5 --depth 1 https://github.com/louislam/uptime-kuma.git /opt/uptime-kuma
Prüfen: Die Datei package.json ist vorhanden.
ls /opt/uptime-kuma/package.json
8. Abhängigkeiten installieren
Installiert die npm-Pakete, die der Server braucht, in den Unterordner node_modules. --omit dev lässt Entwicklerwerkzeuge weg, --no-audit die Sicherheitsabfrage bei npm. Das dauert etwa eine halbe Minute.
sudo -u uptime-kuma -H npm ci --omit dev --no-audit
Prüfen: Die letzte Zeile meldet etwa added 652 packages.
9. Vorgebaute Oberfläche herunterladen
Die Weboberfläche wird nicht auf dem eigenen Rechner gebaut. Dieses Skript lädt sie als fertiges Archiv von der Release-Seite auf GitHub und packt sie in den Ordner dist aus.
sudo -u uptime-kuma -H npm run download-dist
Prüfen: Im Ordner dist liegt eine Datei index.html.
ls /opt/uptime-kuma/dist/index.html
Als Dienst einrichten
10. systemd-Dienst anlegen
Das Projekt empfiehlt den Prozessverwalter pm2. Mit systemd geht es ohne weiteres Werkzeug, und der Dienst startet beim Hochfahren mit.
sudo nano /etc/systemd/system/uptime-kuma.service
Trage Folgendes ein:
[Unit]
Description=Uptime Kuma
Documentation=https://github.com/louislam/uptime-kuma
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=uptime-kuma
WorkingDirectory=/opt/uptime-kuma
Environment=UPTIME_KUMA_HOST=127.0.0.1
Environment=UPTIME_KUMA_PORT=3001
ExecStart=/usr/bin/node server/server.js
Restart=on-failure
[Install]
WantedBy=multi-user.target
Was die Zeilen bewirken:
UserundWorkingDirectorylassen den Server alsuptime-kumaim Programmordner laufen. Die Daten landen dadurch in/opt/uptime-kuma/data.UPTIME_KUMA_HOST=127.0.0.1beschränkt den Server auf den eigenen Rechner,UPTIME_KUMA_PORTlegt den Port fest.ExecStartstartet den Server direkt mit dem Node.js aus Ubuntu.Restart=on-failurestartet ihn nach einem Absturz neu.
Speichere mit Strg+O und Enter und schließe nano mit Strg+X.
11. systemd die neue Datei mitteilen
sudo systemctl daemon-reload
12. Dienst starten und für den Systemstart anmelden
sudo systemctl enable --now uptime-kuma
13. Prüfen, ob der Dienst läuft
systemctl status uptime-kuma
Prüfen: In der Zeile Active steht active (running). Mit q verlässt du die Anzeige. Beim ersten Start legt Uptime Kuma seine Datenbank an. Die Meldungen dazu zeigt journalctl -u uptime-kuma.
14. Prüfen, dass Uptime Kuma nur lokal lauscht
ss -ltn | grep 3001
Prüfen: Die Zeile enthält 127.0.0.1:3001.
Erste Einrichtung
15. Uptime Kuma im Browser öffnen
xdg-open http://127.0.0.1:3001
16. Datenbank wählen
Beim ersten Aufruf fragt Uptime Kuma „Welche Datenbank möchtest du verwenden?“. Stelle oben bei Sprache auf Deutsch um, wähle SQLite und klicke auf Weiter. SQLite ist eine einfache Datenbankdatei und reicht für einige hundert Monitore. Das Einrichten kann einen Moment dauern.
17. Administrator-Konto anlegen
Unter Erstelle dein Administrator-Konto trägst du Benutzername, Passwort und Passwort wiederholen ein und klickst auf Erstellen. Danach öffnet sich das Dashboard.
Ersten Monitor anlegen
18. Monitor hinzufügen
Klicke oben links auf Neuen Monitor hinzufügen.
19. Monitor einrichten
- Monitortyp: HTTP(s) für eine Website.
- Anzeigename: ein Name für die Liste, z. B.
Meine Website. - URL: die vollständige Adresse, z. B.
https://example.org. - Heartbeat-Intervall: wie oft geprüft wird, Vorgabe 60 Sekunden.
- Wiederholungen: wie oft eine fehlgeschlagene Prüfung wiederholt wird, bevor der Monitor als Offline gilt.
Klicke unten auf Speichern.
Prüfen: Der Monitor erscheint links in der Liste. Nach der ersten Prüfung zeigt er Online und einen grünen Balken. Rechts stehen Antwortzeit, Verfügbarkeit und bei HTTPS das Ablaufdatum des Zertifikats (Zert.-Ablauf).
20. Ausfall ausprobieren
Lege zum Test einen zweiten Monitor vom Typ HTTP(s) mit einer Adresse an, die es nicht gibt, z. B. http://127.0.0.1:9.
Prüfen: Der Monitor wechselt nach den eingestellten Wiederholungen auf Offline mit rotem Balken. Lösche ihn danach über Löschen.
Benachrichtigung einrichten (optional)
21. Benachrichtigung anlegen
Öffne oben rechts über das Profilbild die Einstellungen und dort Benachrichtigungen. Klicke auf Benachrichtigung einrichten, wähle den Benachrichtigungstyp, z. B. E-Mail (SMTP), Telegram oder ntfy, und trage die Zugangsdaten ein. Testen schickt eine Probenachricht.
Setzt du ein Häkchen bei Standardmäßig aktiviert, gilt die Benachrichtigung für alle neuen Monitore. Auf alle bestehenden Monitore anwenden schaltet sie für die schon angelegten ein. Klicke auf Speichern.
Aktualisieren
22. Dienst anhalten
sudo systemctl stop uptime-kuma
23. Neue Version holen
Ersetze 2.5.5 durch die neue Versionsnummer von der Release-Seite https://github.com/louislam/uptime-kuma/releases. Die Befehle laufen im Programmordner.
cd /opt/uptime-kuma
sudo -u uptime-kuma -H git fetch --depth 1 origin tag 2.5.5
sudo -u uptime-kuma -H git checkout --force 2.5.5
24. Abhängigkeiten und Oberfläche erneuern
sudo -u uptime-kuma -H npm install --omit dev --no-audit
sudo -u uptime-kuma -H npm run download-dist
25. Dienst wieder starten
sudo systemctl start uptime-kuma
Tipp: Sichere vor jedem Update den Ordner
/opt/uptime-kuma/data, z. B. mitsudo cp -a /opt/uptime-kuma/data /var/backups/uptime-kuma-data. Er enthält alle Monitore, Einstellungen und den Verlauf.
Wie geht es weiter?
- Passwort vergessen: Im Programmordner setzt
sudo -u uptime-kuma -H npm run reset-passworddas Passwort des Administrator-Kontos zurück. - Statusseite: Unter Statusseiten → Neue Statusseite fasst du Monitore auf einer öffentlichen Seite zusammen. Dafür muss Uptime Kuma über nginx mit eigener Domain erreichbar sein. nginx muss dabei WebSockets durchreichen, Hinweise stehen im Wiki unter „Reverse Proxy“.
- Update-Prüfung: Unter Einstellungen → Über lässt sich Auf GitHub nach Updates suchen abschalten.
- Andere Prüfarten: Neben HTTP(s) gibt es u. a. Ping, TCP Port, DNS, HTTP(s) - Schlüsselwort (sucht einen Text in der Seite) und Datenbankprüfungen.
- Dokumentation: https://github.com/louislam/uptime-kuma/wiki
Deinstallieren
1. Dienst anhalten und abmelden
sudo systemctl disable --now uptime-kuma
2. Dienstdatei löschen
sudo rm /etc/systemd/system/uptime-kuma.service
3. systemd die Änderung mitteilen
sudo systemctl daemon-reload
4. Programm und Daten löschen
Achtung: Damit sind alle Monitore, Einstellungen und der gesamte Verlauf unwiderruflich gelöscht.
sudo rm -rf /opt/uptime-kuma
5. Systembenutzer entfernen
sudo deluser uptime-kuma
6. Node.js und npm entfernen (optional)
Nur wenn kein anderes Programm sie braucht. git bleibt in der Regel installiert, weil es oft auch anderweitig genutzt wird.
sudo apt purge nodejs npm
sudo apt autoremove --purge
Prüfen: Port 3001 ist frei, der Befehl gibt nichts aus.
ss -ltn | grep 3001
Quellen und Lizenz
- Offizielle Dokumentation: https://github.com/louislam/uptime-kuma
- Lizenz: Uptime Kuma steht unter der MIT.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.