ioBroker Node.js 22 aktualisieren

Node.js 20 hat am 30. April 2026 sein Lebensende erreicht und bekommt seither keine Sicherheitsupdates mehr. Wer ioBroker darauf betreibt, sollte den Wechsel auf Version 22 nicht mehr lange aufschieben. Das Update ist in zwanzig Minuten erledigt, wenn man die Reihenfolge einhält.

Welche Version es sein soll

Die offizielle Empfehlung des ioBroker-Projekts lautet Node.js 22.x. Diese Version läuft nach Aussage der Entwickler stabil und ohne bekannte Probleme mit den gängigen Adaptern.

Node.js 24 wird vom js-controller 7 zwar erkannt, gilt dort aber als experimentell. Für ein Produktivsystem mit vielen Adaptern ist das der falsche Ort zum Ausprobieren. Wer weniger Adapter betreibt und Lust auf einen Test hat, kann es wagen, sollte aber ein funktionierendes Backup danebenlegen.

Ein Blick auf die Verträglichkeit lohnt sich vorab:

• js-controller 6.x arbeitet mit Node.js 18, 20 und 22.
• js-controller 7.x arbeitet mit Node.js 18, 20 und 22, dazu experimentell mit 24.

Wer noch auf js-controller 5 oder älter unterwegs ist, aktualisiert erst den Controller und danach Node.js.

Vorbereitung

Zuerst schauen, was überhaupt läuft:

node -v
npm -v
iob -v

Danach ein Backup. Entweder über den Adapter BackitUp oder direkt auf der Kommandozeile:

iob backup

Das Backup gehört auf ein anderes Gerät, nicht nur auf die SD-Karte, die man gleich anfasst.

Als Nächstes die Adapter auf den aktuellen Stand bringen. Alte Adapterversionen sind die häufigste Ursache dafür, dass nach dem Wechsel etwas nicht startet:

iob update
iob upgrade all

Das eigentliche Update

ioBroker vollständig anhalten:

iob stop

Dann das Update anstoßen. Der mitgelieferte Befehl erledigt die Quellenverwaltung und die Installation in einem Rutsch:

iob nodejs-update 22

Ohne Versionsangabe installiert der Befehl die jeweils empfohlene Fassung. Die Angabe der 22 schadet trotzdem nicht, weil die interne Versionsliste gelegentlich einen halben Tag hinterherhängt. Mit ausdrücklicher Nummer greift das Update sofort.

Nach dem Update prüfen

Der wichtigste Test betrifft die Pfade. Wenn mehrere Node-Installationen im System liegen, greift ioBroker möglicherweise auf die falsche zu:

which -a node nodejs npm
node -v
npm -v

Jeder Befehl sollte genau einen Pfad zurückgeben, üblicherweise unter /usr/bin. Tauchen zwei Einträge auf, liegt eine alte Installation herum, die entfernt gehört.

Danach die Rechte und Sicherheitseinstellungen wiederherstellen und starten:

iob fix
iob start

Beim ersten Start passiert im Hintergrund noch etwas. Adapter mit nativen Modulen müssen für die neue Node-Version neu übersetzt werden. Seit js-controller 3.0 läuft das von allein, dauert je nach Hardware aber einige Minuten. Auf einem Raspberry Pi lohnt sich Geduld, bevor man an der Oberfläche etwas für kaputt hält.

Wenn etwas hakt

Der Rückweg ist offen. Läuft nach dem Wechsel etwas Wichtiges nicht mehr, bringt ein einzelner Befehl das System zurück:

iob nodejs-update 20

Das ist als Notlösung gedacht und nicht als Dauerzustand, weil Version 20 keine Sicherheitsupdates mehr bekommt.

Für die Fehlersuche gibt es in der Community zwei Werkzeuge, die vor jedem Forumsbeitrag helfen. Das NodeJS Fixer Script räumt zerschossene Installationen auf, das Linux Toolkit prüft das System auf typische Stolperstellen. Einen ersten Überblick liefert außerdem:

iob diag

Die Ausgabe davon gehört in jede Frage im ioBroker-Forum. Ohne sie folgt als erste Antwort ohnehin die Bitte darum.

Ein Hinweis zur Haltbarkeit

Node.js 22 wird bis April 2027 gepflegt. Das ist gut ein halbes Jahr weniger, als viele erwarten, denn die Version ist bereits in der Wartungsphase.

Der Wechsel auf 22 ist also eher ein Zwischenschritt als eine Lösung für die nächsten Jahre. Sobald ioBroker Node.js 24 offiziell empfiehlt, steht die nächste Runde an. Wer das lästig findet, kann darauf warten und bis dahin auf 20 bleiben. Man handelt sich damit allerdings ein System ein, das offene Sicherheitslücken behält.

Fazit

Das Update selbst ist unspektakulär, wenn Backup und Adapteraktualisierung vorher erledigt sind. Die meisten Probleme, die im Forum landen, entstehen durch übersprungene Schritte oder durch mehrere Node-Installationen auf demselben System.

Die Reihenfolge lautet: sichern, Adapter aktualisieren, anhalten, aktualisieren, Pfade prüfen, reparieren, starten. Wer sie einhält, ist in einer halben Stunde fertig und hat wieder ein System mit Sicherheitsunterstützung.

---

Transparenzhinweis KI

Auf dieser Website werden vereinzelt Texte, Bilder und Grafiken mit Unterstützung künstlicher Intelligenz erstellt oder bearbeitet. Alle Inhalte werden vor der Veröffentlichung sorgfältig geprüft, redaktionell überarbeitet und verantwortet.

Transparenzhinweis: Die Amazon-Links in diesem Artikel sind Partnerlinks. Wenn Sie darüber bestellen, erhalten wir eine kleine Provision. Für Sie ändert sich am Preis nichts.