Der IceWhale-Community-Thread von 2023 über Uptime Kuma ist eher eine Einführung als eine Installationsanleitung. Im Beitrag steht, dass das Tutorial die Installation auf CasaOS behandelt, während sich die Antworten darauf konzentrieren, warum Nutzer Uptime Kuma schätzen: Ausfallbenachrichtigungen, Produktionsüberwachung für nicht kritische Dienste und Push-Monitore. Der Forumstext selbst enthält keine schrittweise Konfiguration des Installationsprogramms.
Eine nützliche aktuelle Seite sollte daher den CasaOS-Kontext und die Anwendungsfälle der Community beibehalten, für die eigentliche Bereitstellung jedoch die von Uptime Kuma gepflegten Docker-Anforderungen verwenden.
Was Uptime Kuma zu einem Heimserver hinzufügt
Uptime Kuma ist ein selbst gehostetes Überwachungs-Dashboard. Es kann prüfen, ob eine Website, ein TCP-Dienst, ein DNS-Endpunkt, ein Ping-Ziel, ein Docker-bezogener Dienst oder ein Push-basierter Job erreichbar beziehungsweise funktionsfähig ist, und bei Statusänderungen Benachrichtigungen senden.
In den ursprünglichen Antworten wurden Benachrichtigungen wiederholt als praktischer Vorteil hervorgehoben. Ein Dashboard ist nützlich, aber der Hauptvorteil besteht darin, von einem Ausfall zu erfahren, bevor jemand im Haushalt ihn meldet.
Den aktuellen Uptime-Kuma-Container verwenden
Die aktuellen Bereitstellungsanweisungen für Uptime Kuma verwenden das gepflegte Image louislam/uptime-kuma:2. Die Webanwendung lauscht auf Port 3001 und speichert ihre persistente Datenbank und Konfiguration unter /app/data.
Für eine aktuelle benutzerdefinierte CasaOS-Anwendung sollten Sie die gepflegten Docker-Installationseinstellungen von Uptime Kuma in das CasaOS-App-Formular übertragen, anstatt ein altes Image-Tag aus einem Video von 2023 zu verwenden.
Das Dashboard auf Port 3001 bereitstellen
Der Webdienst im Container verwendet den TCP-Port 3001. Wenn dieser Host-Port bereits belegt ist, ordnen Sie einen anderen Host-Port dem Container-Port 3001 zu und öffnen Sie die CasaOS-App über den gewählten Host-Port.
Eine Änderung des Host-Ports erfordert keine Änderung des internen Uptime-Kuma-Ports, sofern die Upstream-Anwendung eine solche Änderung nicht ausdrücklich unterstützt und benötigt.
/app/data persistent speichern
Ordnen Sie einen CasaOS-Hostordner oder ein Docker-Volume /app/data zu. Dies ist das wichtige Backup-Ziel, da es die Überwachungskonfiguration, Benutzerdaten und die SQLite-Datenbank enthält.
Wenn der Container ohne dieses persistente Volume neu erstellt wird, verhält er sich wie eine frische Uptime-Kuma-Installation.
Die Datenbank auf einem Dateisystem mit zuverlässiger Sperrung speichern
Die aktuellen Hinweise von Uptime Kuma warnen, dass die SQLite-Datenbank eine zuverlässige POSIX-Dateisperrung benötigt, und weisen ausdrücklich auf Probleme mit Dateisystemen wie vielen NFS-Konfigurationen für das Datenverzeichnis hin.
Für einen Heimserver ist es am einfachsten, /app/data auf einem lokalen Speicher abzulegen. Anschließend können Sie dieses lokale Verzeichnis auf eine andere Festplatte oder ein entferntes Ziel sichern.
Monitore passend zur gewünschten Nutzung auswählen
Ein Ping-Monitor bestätigt nur, dass ein Rechner auf ICMP antwortet. Wenn die eigentliche Anforderung lautet: „Jellyfin soll geladen werden“, ist ein HTTP-Monitor für den Jellyfin-Endpunkt aussagekräftiger.
Eine praktische Auswahl kann Folgendes umfassen:
- HTTP-Prüfungen für Webanwendungen;
- TCP-Prüfungen für Dienste ohne sinnvollen Web-Endpunkt;
- DNS-Prüfungen für Pi-hole oder AdGuard Home;
- Ping-Prüfungen für die grundlegende Erreichbarkeit eines Hosts;
- Push-Monitore für geplante Jobs, die den Abschluss melden sollen.
Warum der im Thread erwähnte Push-Monitor wichtig ist
Ein Community-Teilnehmer sagte ausdrücklich, dass er Push-Monitore häufig verwendet. Statt dass Uptime Kuma einen Dienst abfragt, ruft ein Backup-Skript oder ein geplanter Job bei erfolgreicher Ausführung eine eindeutige URL auf. Wenn dieser Heartbeat nicht innerhalb des erwarteten Zeitfensters eintrifft, markiert Uptime Kuma den Monitor als fehlerhaft.
Das ist für Aufgaben nützlich, bei denen „der Server ist online“ nicht beweist, dass der Job tatsächlich ausgeführt wurde.
Benachrichtigungen vor dem ersten Ausfall testen
Konfigurieren Sie mindestens einen Benachrichtigungskanal und lösen Sie absichtlich eine Testwarnung aus. Ein Überwachungssystem, das Benachrichtigungen nicht zuverlässig sendet, ist nur ein historisches Dashboard.
Berücksichtigen Sie bei Diensten im Haushalt außerdem die Gefahr der Alarmmüdigkeit. Wenn jeder geringfügige Endpunkt mit sofortigen Benachrichtigungen überwacht wird, können echte Ausfälle leichter ignoriert werden.
Das Überwachungs-Dashboard privat halten, sofern der Fernzugriff nicht beabsichtigt ist
Uptime Kuma kann interne Hostnamen, Dienstnamen, Netzwerkadressen und die Ausfallhistorie offenlegen. Setzen Sie es nicht direkt dem öffentlichen Internet aus, nur weil eine Fernüberwachung nützlich ist. Verwenden Sie bei notwendigem Fernzugriff ein VPN, ein privates Overlay-Netzwerk oder einen authentifizierten Reverse-Proxy.
Den CasaOS-Thread von 2023 nicht als aktuelle Versionsfestlegung betrachten
Die Quelldiskussion lobt eine gut gepflegte Anwendung, enthält jedoch keine Image-Version. Das ist von Vorteil: Verwenden Sie die aktuelle Upstream-Version, anstatt exakt den Container nachzubilden, der im September 2023 existierte.
FAQ zu Uptime Kuma auf CasaOS
Welchen Port verwendet die aktuelle Version von Uptime Kuma?
Port 3001 für die Weboberfläche.
Welches Verzeichnis muss persistent gespeichert werden?
/app/data.
Warum sollte das Datenverzeichnis auf lokalem Speicher bleiben?
Die SQLite-Datenbank benötigt eine zuverlässige Dateisperrung, und die aktuellen Hinweise des Upstream-Projekts warnen vor ungeeigneten Netzwerkdateisystemen.
Was schätzte die ursprüngliche Community am meisten?
Benachrichtigungen und die Funktion für Push-Monitore wurden in den Antworten wiederholt hervorgehoben.
