Neuer ioBroker-Blog online: Monatsrückblick März/April 2026

[H5N1]

Aktuelle Version
Stable 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.

[Dr. Bakterius]

@H5N1 Ich habe vor einigen Wochen den nextcloud-Adapter und den sonoff-Adapter deinstalliert und beide wieder neu eingerichtet. Seitem gibt es keine Probleme mehr. Keine Ahnung warum sich die beiden in die Quere gekommen sind.

[H5N1]

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

Ich habe vor einigen Wochen den nextcloud-Adapter und den sonoff-Adapter deinstalliert und beide wieder neu eingerichtet. Seitem gibt es keine Probleme mehr. Keine Ahnung warum sich die beiden in die Quere gekommen sind.

Danke für deine Rückmeldung

[H5N1]

Neue Version 2.0.5.

Es wurde das Sentry-Plugin hinzugefügt und ein entsprechender Eintrag in der README ergänzt.

• Dieser Adapter nutzt die Sentry-Bibliotheken, um Ausnahmen und Codefehler automatisch an die Entwickler zu melden. Weitere Informationen und Anweisungen zum Deaktivieren der Fehlerberichterstattung finden Sie in der Sentry-Plugin-Dokumentation . Die Sentry-Berichterstattung wird ab js-controller 3.0 unterstützt.

• Ich nutze meinen eigenen Sentry-Server, der auf Glitchtip basiert.

Changelog:

• (v 2.0.5) Sentry-Plugin hinzugefügt, um Fehler automatisch an Entwickler zu melden
• (v 2.0.4) Abhängigkeiten aktualisiert,
  fix: Aktualisierung des Status-Typs der Trefferrate des Opcache von Zeichenkette zu Zahl

Adapterupdate: Bitte den Adapter Stoppen, Update einspielen, kompletten Verzeichnisbaum löschen, Adapter starten und Verzeichnisbaum neu erstellen lassen.

[Dr. Bakterius]

https://github.com/H5N1v2/ioBroker.nextcloud-monitoring/issues/16

Auch nach durchgeführtem Update wird immer noch angezeigt, dass es zur Verfügung steht. Adapter gestoppt - Verzeichnisbaum gelöscht - Adapter gestartet -> keine Änderung

Im Log (debug) gibt es keine Auffälligkeiten.

[H5N1]

@Dr.-Bakterius sagte:

Auch nach durchgeführtem Update wird immer noch angezeigt

Wenn du die API im Browser aufrufst, gibt sie dort auch true wieder? Überprüfe bitte auch last_update_check, bei dir 1/1/1970 das bedeutet praktisch nie.

Führe bitte mal ein "occ maintenance:update:check" aus und schau ob sich der Wert im Adapter mit dem nächsten Abruf ändert.

Ich nehme an das du docker verwendest? Ich verwende die Web Version. Falls es docker ist prüfe bitte ob die Punkte in deiner API überhaupt existieren, da ich docker nicht verwende kann ich das nicht prüfen. Sollten die Punkte existieren und die Werte dort die selben sein liegt es nicht am Adapter.

[Dr. Bakterius]

@H5N1 Entschuldige, ich hatte deine Antwort erst jetzt gesehen.

Nextcloud läuft auf einem gemieteten Webspace, ioBroker in einem Container unter Proxmox. Also kein Docker. Ich habe bei aufruf von curl -u user:pass -H "OCS-APIREQUEST: true" "https://cloud.domain.tld/ocs/v2.php/cloud/capabilities" folgende Ausgabe erhalten:

Spoiler

<?xml version="1.0"?>
<ocs>
<meta>
<status>ok</status>
<statuscode>200</statuscode>
<message>OK</message>
</meta>
<data>
<version>
<major>33</major>
<minor>0</minor>
<micro>2</micro>
<string>33.0.2</string>
<edition></edition>
<extendedSupport></extendedSupport>
</version>
<capabilities>
<core>
<pollinterval>60</pollinterval>
<webdav-root>remote.php/webdav</webdav-root>
<reference-api>1</reference-api>
<reference-regex>(\s|\n|^)(https?://)([-A-Z0-9+.]+(?::[0-9]+)?(?:/[-A-Z0-9+&@#%?=~|!:,.;()]))(\s|\n|$)</reference-regex>
<mod-rewrite-working></mod-rewrite-working>
<user>
<language>de</language>
<locale></locale>
<timezone>Europe/Berlin</timezone>
</user>
<can-create-app-token>1</can-create-app-token>
</core>
<bruteforce>
<delay>0</delay>
<allow-listed></allow-listed>
</bruteforce>
<files>
<!--"blacklisted_files" is deprecated as of Nextcloud 30, use "forbidden_filenames" instead-->
<blacklisted_files>
<element>.htaccess</element>
</blacklisted_files>
<forbidden_filenames>
<element>.htaccess</element>
</forbidden_filenames>
<forbidden_filename_basenames/>
<forbidden_filename_characters>
<element></element>
<element>/</element>
</forbidden_filename_characters>
<forbidden_filename_extensions>
<element>.filepart</element>
<element>.part</element>
</forbidden_filename_extensions>
<bigfilechunking>1</bigfilechunking>
<chunked_upload>
<max_size>104857600</max_size>
<max_parallel_count>5</max_parallel_count>
</chunked_upload>
<file_conversions/>
<windows_compatible_filenames></windows_compatible_filenames>
<directEditing>
<url>https://cloud.domain.tld/ocs/v2.php/apps/files/api/v1/directEditing</url>
<etag>1dc1b8f0cb70e547508c330170656228</etag>
<supportsFileId>1</supportsFileId>
</directEditing>
<comments>1</comments>
<undelete>1</undelete>
<delete_from_trash>1</delete_from_trash>
<versioning>1</versioning>
<version_labeling>1</version_labeling>
<version_deletion>1</version_deletion>
</files>
<activity>
<apiv2>
<element>filters</element>
<element>filters-api</element>
<element>previews</element>
<element>rich-strings</element>
</apiv2>
</activity>
<calendar>
<webui>1</webui>
</calendar>
<circles>
<version>33.0.0</version>
<status>
<globalScale></globalScale>
</status>
<settings>
<frontendEnabled>1</frontendEnabled>
<allowedCircles>262143</allowedCircles>
<allowedUserTypes>31</allowedUserTypes>
<membersLimit>-1</membersLimit>
</settings>
<circle>
<constants>
<flags>
<element>Einzeln</element>
<element>Persönlich</element>
<element>System</element>
<element>Sichtbar</element>
<element>Offen</element>
<element>Einladen</element>
<element>Beitrittsanfrage</element>
<element>Freunde</element>
<element>Passwortgeschützt</element>
<element>Kein Besitzer</element>
<element>Versteckt</element>
<element>Backend</element>
<element>Lokal</element>
<element>Root</element>
<element>Teameinladung</element>
<element>Federated</element>
<element>Einhängepunkt</element>
</flags>
<source>
<core>
<element>Nextcloud-Konto</element>
<element>Nextcloud-Gruppe</element>
<element>E-Mail-Adresse</element>
<element>Kontakt</element>
<element>Team</element>
<element>Nextcloud-App</element>
</core>
<extra>
<element>Teams-App</element>
<element>Administrations-Befehlszeile</element>
</extra>
</source>
</constants>
<config>
<coreFlags>
<element>1</element>
<element>2</element>
<element>4</element>
</coreFlags>
<systemFlags>
<element>512</element>
<element>1024</element>
<element>2048</element>
</systemFlags>
</config>
</circle>
<member>
<constants>
<level>
<element>Mitglied</element>
<element>Moderator</element>
<element>Administration</element>
<element>Eigentümer</element>
</level>
</constants>
<type>
<element>single</element>
<element>user</element>
<element>group</element>
<element>mail</element>
<element>contact</element>
<element>circle</element>
<element>app</element>
</type>
</member>
<teamResourceProviders>
<element>files</element>
</teamResourceProviders>
</circles>
<ocm>
<enabled>1</enabled>
<apiVersion>1.0-proposal1</apiVersion>
<version>1.1.0</version>
<endPoint>https://cloud.domain.tld/index.php/ocm</endPoint>
<publicKey/>
<provider>Nextcloud 33.0.2.2</provider>
<resourceTypes>
<element>
<name>file</name>
<shareTypes>
<element>user</element>
<element>group</element>
</shareTypes>
<protocols>
<webdav>/public.php/webdav/</webdav>
</protocols>
</element>
</resourceTypes>
<capabilities>
<element>invite-accepted</element>
<element>notifications</element>
<element>shares</element>
</capabilities>
</ocm>
<client_integration>
<contacts>
<version>0.1</version>
<context-menu>
<element>
<name>Kontakte importieren</name>
<url>/ocs/v2.php/apps/contacts/api/v1/import/{fileId}</url>
<method>POST</method>
<mimetype_filters>text/vcard</mimetype_filters>
</element>
</context-menu>
</contacts>
</client_integration>
<dav>
<chunking>1.0</chunking>
<public_shares_chunking>1</public_shares_chunking>
<search_supports_creation_time>1</search_supports_creation_time>
<search_supports_upload_time>1</search_supports_upload_time>
<search_supports_last_activity>1</search_supports_last_activity>
<bulkupload>1.0</bulkupload>
<absence-supported>1</absence-supported>
<absence-replacement>1</absence-replacement>
</dav>
<downloadlimit>
<enabled>1</enabled>
<default-limit>-1</default-limit>
</downloadlimit>
<files_sharing>
<api_enabled>1</api_enabled>
<public>
<enabled>1</enabled>
<password>
<enforced></enforced>
<askForOptionalPassword></askForOptionalPassword>
</password>
<expire_date>
<enabled></enabled>
</expire_date>
<multiple_links>1</multiple_links>
<expire_date_internal>
<enabled></enabled>
</expire_date_internal>
<expire_date_remote>
<enabled></enabled>
</expire_date_remote>
<send_mail></send_mail>
<upload>1</upload>
<upload_files_drop>1</upload_files_drop>
<custom_tokens></custom_tokens>
</public>
<resharing>1</resharing>
<user>
<send_mail></send_mail>
<expire_date>
<enabled>1</enabled>
</expire_date>
</user>
<group_sharing>1</group_sharing>
<group>
<enabled>1</enabled>
<expire_date>
<enabled>1</enabled>
</expire_date>
</group>
<default_permissions>31</default_permissions>
<exclude_reshare_from_edit></exclude_reshare_from_edit>
<federation>
<outgoing>1</outgoing>
<incoming>1</incoming>
<expire_date>
<enabled>1</enabled>
</expire_date>
<expire_date_supported>
<enabled>1</enabled>
</expire_date_supported>
</federation>
<sharee>
<query_lookup_default></query_lookup_default>
<always_show_unique>1</always_show_unique>
</sharee>
<sharebymail>
<enabled>1</enabled>
<send_password_by_mail>1</send_password_by_mail>
<upload_files_drop>
<enabled>1</enabled>
</upload_files_drop>
<password>
<enabled>1</enabled>
<enforced></enforced>
</password>
<expire_date>
<enabled>1</enabled>
<enforced></enforced>
</expire_date>
</sharebymail>
</files_sharing>
<notifications>
<ocs-endpoints>
<element>list</element>
<element>get</element>
<element>delete</element>
<element>delete-all</element>
<element>icons</element>
<element>rich-strings</element>
<element>action-web</element>
<element>user-status</element>
<element>exists</element>
<element>test-push</element>
</ocs-endpoints>
<push>
<element>devices</element>
<element>object-data</element>
<element>delete</element>
</push>
<admin-notifications>
<element>ocs</element>
<element>cli</element>
</admin-notifications>
</notifications>
<password_policy>
<api>
<generate>https://cloud.domain.tld/ocs/v2.php/apps/password_policy/api/v1/generate</generate>
<validate>https://cloud.domain.tld/ocs/v2.php/apps/password_policy/api/v1/validate</validate>
</api>
<policies>
<account>
<minLength>10</minLength>
<enforceHaveIBeenPwned>1</enforceHaveIBeenPwned>
<enforceNonCommonPassword>1</enforceNonCommonPassword>
<enforceNumericCharacters></enforceNumericCharacters>
<enforceSpecialCharacters></enforceSpecialCharacters>
<enforceUpperLowerCase></enforceUpperLowerCase>
</account>
</policies>
<minLength>10</minLength>
<enforceNonCommonPassword>1</enforceNonCommonPassword>
<enforceNumericCharacters></enforceNumericCharacters>
<enforceSpecialCharacters></enforceSpecialCharacters>
<enforceUpperLowerCase></enforceUpperLowerCase>
</password_policy>
<provisioning_api>
<version>1.23.0</version>
<AccountPropertyScopesVersion>2</AccountPropertyScopesVersion>
<AccountPropertyScopesFederatedEnabled>1</AccountPropertyScopesFederatedEnabled>
<AccountPropertyScopesPublishedEnabled></AccountPropertyScopesPublishedEnabled>
</provisioning_api>
<recommendations>
<enabled>1</enabled>
</recommendations>
<systemtags>
<enabled>1</enabled>
</systemtags>
<theming>
<name>Nextcloud</name>
<productName>Nextcloud</productName>
<url>https://nextcloud.com</url>
<slogan>ein sicherer Ort für all deine Daten</slogan>
<color>#00679e</color>
<color-text>#ffffff</color-text>
<color-element>#00679e</color-element>
<color-element-bright>#00679e</color-element-bright>
<color-element-dark>#00679e</color-element-dark>
<logo>https://cloud.domain.tld/core/img/logo/logo.svg?v=0</logo>
<background>https://cloud.domain.tld/apps/theming/img/background/jo-myoung-hee-fluid.webp</background>
<background-text>#ffffff</background-text>
<background-plain></background-plain>
<background-default>1</background-default>
<logoheader>https://cloud.domain.tld/core/img/logo/logo.svg?v=0</logoheader>
<favicon>https://cloud.domain.tld/core/img/logo/logo.svg?v=0</favicon>
</theming>
<user_status>
<enabled>1</enabled>
<restore>1</restore>
<supports_emoji>1</supports_emoji>
<supports_busy>1</supports_busy>
</user_status>
<weather_status>
<enabled>1</enabled>
</weather_status>
</capabilities>
</data>
</ocs>

Da ist nichts zu finden ob update true oder false ist. Oder muss der Aufruf anders lauten?

Wenn ich "occ maintenance:update:check" am server ausführe, bekomme ich das zurück:

Command "maintenance:update:check" is not defined.

Did you mean one of these?
app:update
maintenance:update:htaccess
photos:update-1000-cities
serverinfo:update-storage-statistics

Der Zeitstempel der Datenpunkte ändert sich aber. Also schreibt der Adapter auch, wenn er nichts empfängt?