Jahresrückblick 2025 – unser neuer Blogbeitrag ist online! ✨

[H5N1]

Aktuelle Test Version
Veröffentlichungsdatum	16.01.2026
Github Link	https://github.com/H5N1v2/ioBroker.nextcloud-monitoring
NPM Link	https://www.npmjs.com/package/iobroker.nextcloud-monitoring

Hallo zusammen,

für alle Nextcloud-Selbsthoster habe ich einen neuen Adapter entwickelt: ioBroker.nextcloud-monitoring.

Der Adapter zapft die offizielle "Server-Info" API deiner Nextcloud-Instanz an und bringt die wichtigsten Status-Werte direkt in die ioBroker-Objekte.

Was wird überwacht?

Der Adapter liefert euch (je nach Konfiguration der Nextcloud) folgende Daten:

• System-Status: CPU-Last, RAM-Verbrauch, Speicherplatz (Data-Directory).
• Software: Versionen von Nextcloud, PHP und der Datenbank.
• Sicherheit: Anzahl der ausstehenden Updates (Core & Apps).
• Aktivität: Anzahl der aktiven Nutzer (letzte 5 Min, 1 Std, 24 Std).
• Webserver: Status von Apache/Nginx.

Für die schnelle Übersicht habe ich dazu ein simples aber übersichtliches Widget gebastelt, was die wichtigsten Infos anzeigt, mehr Infos gibt es in der Readme. Es handelt sich bei dem Widget nicht um einen Adapter.

Voraussetzungen

1. Eine laufende Nextcloud-Instanz.
2. Die App "Server Info" muss in Nextcloud aktiviert sein (ist sie standardmäßig meistens).
3. Ein Benutzer mit Admin-Rechten (oder ein spezielles App-Passwort), um die API auszulesen. Wie es geht steht in der Readme.

Installation

Der Adapter kann über GitHub getestet werden:
ioBroker.nextcloud-monitoring oder über npm

Feedback erwünscht

Da Nextcloud-Instanzen je nach Hoster (Docker, Bare-Metal, Shared-Hosting) sehr unterschiedlich reagieren, brauche ich euer Feedback:

• Werden alle Werte korrekt ausgelesen?
• Gibt es Probleme bei der Authentifizierung?
• Gibt es sonstige Probleme, berichtet bitte hier oder eröffnet auf Github ein Issues

Ich freue mich über eure Tests und Rückmeldungen!

PS: Ich bin kein Profi Entwickler und mache es zum Spaß in meiner Freizeit, ich wünsche mir Nachsicht im Fall wenn Probleme nicht gleich behoben werden können. Vielen Dank und habt Spaß damit.

Beste Grüße,
H5N1

[Dr. Bakterius]

Super Sache! Grundsätzlich. Ich habe meine NextCloud auf meinem Webspace meines Providers laufen. Da kann ich zwar auch per SSH zugreifen, doch mir fehlen natürlich die sudo-Rechte. Also kann ich zwar den Token erstellen aber nicht in NextCloud integrieren.

Ich habe es mal direkt in NextCloud versucht, indem ich ein App-Passwort für ioBroker angelegt habe und dieses statt des Token im Adapter angegeben habe. Die Instanz zeigt mit grün an, dass die Verbindung hergestellt wurde, allerdings kommen keine Daten rein. nextcloud-monitoring bleibt leer (bis auf admin).

Gibt es dafür eine Lösung?

[Dr. Bakterius]

Im Log erhalte ich 'Request failed with status code 401'. Also kann er sich nicht anmelden. Doch warum wird er dann grün?

[Dr. Bakterius]

Ich habe inzwischen die Lösung selbst gefunden. Zuerst habe ich auf php 8.4 umgestellt und dann den token per ssh so integriert:

php84 occ config:app:set serverinfo token --value <TOKEN>

Jetzt klappt die Verbindung, Daten kommen an. :-)

[H5N1]

@Dr.-Bakterius sagte in Test Adapter nextcloud-monitoring v2.0.x GitHub/Latest:

Jetzt klappt die Verbindung, Daten kommen an. :-)

Super das es jetzt läuft bei dir, das man auf Webspace evtl. kein sudo braucht hatte ich leider nicht auf'm Schirm, denn
in vielen Webspaces gehört der SSH-User derselben Gruppe an wie der Webserver-Prozess. Danke für den Schupps, das wird demnächst mit in die Readme kommen.

Gruß H5N1

[Dr. Bakterius]

@H5N1 sagte in Test Adapter nextcloud-monitoring v2.0.x GitHub/Latest:

wird demnächst mit in die Readme kommen.

Dann erwähne vielleicht auch, dass der Pfad an die örtlichen Gegebenheiten angepasst gehört. Bei meinem Provider ist er z.B. nicht /var/www/nextcloud/ sondern /www/htdocs/<USERNAME>/<ORDNER>. Also am Besten man wechselt erst in den Installationsordner von NextCloud und führt dann erst den Befehl ohne Pfad aus.

[H5N1]

@Dr.-Bakterius sagte in Test Adapter nextcloud-monitoring v2.0.x GitHub/Latest:

Dann erwähne vielleicht auch, dass der Pfad an die örtlichen Gegebenheiten angepasst gehört. Bei meinem Provider ist er z.B. nicht /var/www/nextcloud/ sondern /www/htdocs/<USERNAME>/<ORDNER>. Also am Besten man wechselt erst in den Installationsordner von NextCloud und führt dann erst den Befehl ohne Pfad aus.

Werde ich berücksichtigen, das der Pfad bei jeden anders sein kann, ist mir bewusst. Der Pfad '/var/www/nextcloud/' sollte nur demonstrativ und als Beispiel gelten, ich hätte auch '/phat/to-your/nextcloud-folder/' schreiben können, was vielleicht besser ist.

[Dr. Bakterius]

Ich fände das besser, weil man versucht ist den Befehl einfach zu kopieren und wenn ein Fehler kommt nach der Ursache zu suchen. So wäre es sofort klar, dass man den korrekten Pfad verwenden muss.

Danke für deine Arbeit!

[H5N1]

@dr.-bakterius: wurde nun in der README geändert.

[Dr. Bakterius]

Hallo H5N1!

Ich melde mich hier noch einmal, weil der Adapter offensichtlich irgendeinen Buffer volllaufen lässt. Nach einigen Stunden Betrieb, kommen bei meinen Gosund-Steckdosen die über den Sonoff-Adapter angebunden sind keine Schaltbefehle mehr an. Ist der Adapter aus, klappt wieder alles. Ich habe versucht wirklich alles andere auszuschließen - es bleibt nur der nextcloud-monitoring Adapter.

Siehe auch: https://forum.iobroker.net/topic/83778

[H5N1]

@dr.-bakterius: Welcher Puffer soll denn da volllaufen? Hast evtl. irgendwelche logs für mich? Ohne ist es Rätselraten ob es tatsächlich an dem Adapter liegen soll, er macht ja nichts weiter als alle 10 Minuten über eine API Daten abzurufen und sie in Datenpunkte zu schreiben.
Ich benutze zwar keine Gosund sondern Nous Geräte mit mqtt, läuft aber alles unauffällig bisher.

[H5N1]

@Dr.-Bakterius sagte in Test Adapter nextcloud-monitoring v2.0.x GitHub/Latest:

...weil der Adapter offensichtlich irgendeinen Buffer volllaufen lässt

ich kann es zwar nicht reproduzieren aber ich habe mir den Code noch einmal angeschaut und ein paar Optimierungen gemacht.
Ob es daran nun liegt kann ich mangels Informationen nicht sagen, es kann nur getestet werden.

Neue Version 2.0.1 verfügbar.

Was wurde gemacht:

• Reduzierung der Datenbank-Last: Der Adapter merkt sich jetzt, welche Datenpunkte er bereits erstellt hat. Anstatt bei jedem Abruf (alle 10 Min.) dutzende Male bei ioBroker anzufragen, ob das Objekt existiert (setObjectNotExists), passiert das jetzt nur noch einmalig beim Start. Das spart massiv I/O-Zugriffe auf die Datenbank.

• Sauberes Socket-Management: Es wurde die Netzwerk-Kommunikation zur Nextcloud so umgestellt, dass Verbindungen nach dem Datentransfer explizit sofort geschlossen werden. Das verhindert, dass offene Netzwerk-Sockets im Hintergrund "hängen bleiben" könnte.

• Verbessertes Timing: Die Schreibvorgänge wurden auf vollständig asynchrone Bearbeitung umgestellt, damit die 'Event-Loop' von ioBroker frei bleibt und andere Adapter (wie evtl. Sonoff) nicht durch Millisekunden-Verzögerungen bei der Datenverarbeitung gestört werden.

[Dr. Bakterius]

@H5N1 sagte in Test Adapter nextcloud-monitoring v2.0.x GitHub/Latest:

Welcher Puffer soll denn da volllaufen? Hast evtl. irgendwelche logs für mich?

Keine Ahnung. Logs vom sonoff-Adapter wären viel zu umfangreich. aber ich kann den nextcloud-adapter mal auf 'debug' stellen und mit der v2.0.1 testen

[H5N1]

@Dr.-Bakterius sagte in Test Adapter nextcloud-monitoring v2.0.x GitHub/Latest:

aber ich kann den nextcloud-adapter mal auf 'debug' stellen und mit der v2.0.1 testen

Mehr Möglichkeiten haben wir erst mal nicht.