Wer eigene Dienste hostet – sei es eine Website, ein Mailserver oder die eigene Nextcloud –, möchte über Störungen informiert werden. In diesem Beitrag geht es darum, wie man Uptime Kuma in Kombination mit Nextcloud Talk zur Benachrichtigung verwenden kann.

Was ist Uptime Kuma?

Uptime Kuma ist ein, selbstgehostetes Monitoring-Tool mit einer ansprechenden Weboberfläche. Es überwacht:

• Ob Websites erreichbar sind (HTTP/S).
• Ob Server antworten (Ping, TCP Port).
• Und Datenbanken und sogar Docker-Container.

Wenn ein Dienst ausfällt, zeigt Uptime Kuma das nicht nur in einem Dashboard an, sondern kann auch benachrichtigen oder alarmieren. Und hier kommt Nextcloud ins Spiel.

Weitere Informationen zu Uptime Kuma gibt es hier:

Nextcloud Talk?

Uptime Kuma kann auf vielfältige Weise benachrichtigen beispielsweise E-Mails oder Messenger-Nachrichten. Wenn man ohnehin Nextcloud verwendet, ist es auch interessant, die Fehlermeldungen dort zu bündeln. Keine extra App, keine Drittanbieter-Cloud – alles selber organisiert.

Schritt 1: Den Talk-Bot in Nextcloud anlegen

Ein Bot in Nextcloud Talk ist im Grunde ein digitaler Teilnehmer, der über eine API Nachrichten in Chats schreiben darf. Wir legen ihn über die Kommandozeile (occ) an, da dies am schnellsten geht.

1. Bot erstellen: Im Nextcloud-Verzeichnis folgenden Befehl ausführen:sudo -u www-data php occ talk:bot:setup "UptimeKumaBot" "https://deine-url.de" Wichtig: Secret notieren
2. Status prüfen: Falls der Bot nicht sofort auftaucht, Liste prüfen:sudo -u www-data php occ talk:bot:list
3. Bot aktivieren: Damit Moderatoren den Bot nicht blockieren oder er im System „schläft“, muss der Status auf aktiv (angenommen, die ID ist 2) gesetzt werden:sudo -u www-data php occ talk:bot:state 2 1

Schritt 2: Den Chat-Raum vorbereiten

Ein Bot darf nicht einfach ungefragt in jeden Chat platzen. Du musst ihn einladen:

1. Den gewünschten Talk-Raum öffnen.
2. In den Einstellungen des Raums in den Bereich Bots navigieren.
3. Dort kann man den neuen Bot per Schalter aktivieren.
4. Das Token finden: Am Ende der URL im Browsers findet sich der KonversationsToken (z. B. https://.../call/abcdefgh) ist dein Conversation Token (abcdefgh). Der wird zur Einrichtung benötigt.

Schritt 3: Uptime Kuma konfigurieren

Im Uptime Kuma Dashboard:

1. Einstellungen -> Benachrichtigungen -> Benachrichtigung hinzufügen.
2. Nextcloud Talk auswählen.
3. Instanz URL: Unbedingt die volle Domain (z. B. https://cloud.beispiel.de) angeben. localhost vermeiden, und vor allem https:// berücksichtigen, da dies oft zu Fehlern führt!
4. Den Bot-Namen, das Secret und das Conversation Token eintragen.
5. Dann abspeichern und testen

Fehlerbehebung „ECONNREFUSED“

Ein häufigster Fehler beim Testen der Verbindung ist:

connect ECONNREFUSED ::1:80

Das bedeutet meistens eines von zwei Dingen:

1. Localhost-Konflikt: Uptime Kuma versucht, die Nextcloud über die interne IPv6-Adresse (::1) auf Port 80 zu erreichen. Wenn beide Dienste in Docker-Containern oder auf demselben Server laufen, stelle sicher, dass du die externe HTTPS-URL der Nextcloud verwendest und nicht http://localhost.
2. DNS/Proxy: Prüfe, ob dein Server seine eigene Domain auflösen kann (Stichwort: NAT-Loopback). Der Befehl curl -I https://deine-cloud.de im Terminal hilft dir zu sehen, ob die Verbindung steht.

Mit dieser Kombination hat man eine geeignete Benachrichtigung des Monitoring-Systems, in Echtzeit in der Nextcloud-Umgebung.