Node.js Update

Warum muss man das updaten?

Ohne Node.js funktioniert ioBroker nicht, Details dazu unter Architektur.
Wer mehr über Node.js erfahren möchte, Wikipedia Node.js.

Wie bei vielen Open-Source-Technologien üblich, entwickelt sich Node.js schnell weiter.
Updates, die die Stabilität und Sicherheit steigern, oder gar neue Funktionen hinzufügen, erscheinen regelmäßig.

Node.js 22.x ist die aktuelle Empfehlung für ioBroker-Installationen. Diese Version befindet sich seit Oktober 2024 im Active LTS-Status und wird bis April 2027 unterstützt. Die ioBroker-Community hat diese Version offiziell empfohlen und der iob nodejs-update Befehl installiert automatisch die empfohlene Version.

Node.js 24.x ist seit Oktober 2025 ebenfalls LTS und wird bis April 2028 unterstützt. Sie läuft, ist aber noch nicht die allgemeine Empfehlung: Solange nicht alle Adapter darauf geprüft sind, bleibt 22.x der sichere Weg.

?> Bei einem Node.js Versionswechsel sind bestimmte Voraussetzungen zu prüfen und müssen gegebenenfalls im Vorfeld korrigiert werden.
Dabei ist darauf zu achten, in welchen Pfaden die Installation liegt.

!> Node.js 18.x ist seit April 2025 End-of-Life und erhält keine Sicherheitsupdates mehr. Node.js 22.x ist die empfohlene LTS-Version. Der Admin ab Version 8 setzt Node.js 22 ohnehin voraus.

Empfohlene Update-Methoden

Die einfachste Methode für bestehende ioBroker-Installationen ist der integrierte Update-Befehl:

iob nodejs-update

Vorgehensweise

1 - Gegebenheiten prüfen

• Version und Pfad
• Betriebsystem
• js-controller
• Adapter

2 - Backup erstellen

Bevor nun Änderungen am System gemacht werden, muss ein Backup erstellt werden. Je nach System gibt es verschiedene Möglichkeiten. Empfohlen wird der BackitUp Adapter oder per Kommandozeilenbefehl. Das Backup sollte aktuell sein, damit möglichst keine Daten verloren gehen.

3 - Adapter aktualisieren

Die im System verwendeten Adapter sollten mit der neuen Node.js Version kompatibel sein, gegebenenfalls müssen diese aktualisiert werden.

4 - ioBroker stoppen

Gestoppt wird ioBroker mittels eigenem Konsolenkommando oder per Systemdienstverwaltung.

5 - Überprüfen ob noch Prozesse laufen

In der Regel werden alle Prozesse dadurch beendet. Sicherheitshalber sollte nocheinmal kontrolliert werden, dass auch wirklich keine Prozesse (Adapter, Backups) mehr laufen. Man kann auch mit einem Tool wie "top" prüfen, ob noch Prozesse existieren, die mit "io." beginnen.

6 - Node.js Update

Im nächsten Schritt aktualisiert man Node.js auf die gewünschte neue Version. Das Update unterscheidet sich jedoch je nach installiertem Betriebssystem, siehe Anleitung.

?> Der Node Package Manager, kurz npm, wird dabei ebenfalls automatisch mit aktualisiert.

7 - Version und Pfade kontrollieren

Nach abgeschlossenem Update werden die Pfade und installierten Versionen noch einmal gegengeprüft.

8 - ioBroker fixer ausführen

Da die Installation von Node.js, wie eingangs erwähnt, einige Änderungen am System vornimmt, ist es notwendig im Anschluss den ioBroker fixer auszuführen. Dieser stellt unter anderem die für den Betrieb von ioBroker notwendigen Sicherheitseinstellungen wieder her und prüft und korrigiert alle Berechtigungen.

9 - ioBroker starten

Einige verwendete JavaScript Module beinhalten Teile die kompiliert werden müssen. Dieser Prozess findet bei der Installation statt. Durch das kompilieren sind diese Module an die Node.js Version gebunden. Nach einem Update müssen diese Teile daher neu kompiliert werden. Seit js-controller Version 3.0 wird versucht, Adapter die solche Teile beinhalten, zu erkennen und automatisch einen Rebuild durchzuführen. Dieser Prozess kann einige Zeit in Anspruch nehmen und die betroffenen Adapter können mehrfach neu starten. Dies kann im LogFile beobachtet werden. Dies geht am einfachsten in einem Terminal mittels iob logs --watch | uniq.

iobroker rebuild

iobroker rebuild --install

iob install serialport

Anleitung für Debian/Ubuntu

1 - Version und Pfad prüfen

sudo ln -s /usr/bin/node /usr/bin/nodejs &> /dev/null
type -p nodejs node npm npx corepack && nodejs -v && node -v && npm -v && npx -v && corepack -v

• Ausgabe

/usr/bin/nodejs
/usr/bin/node
/usr/bin/npm
/usr/bin/npx
/usr/bin/corepack
v22.x.x
v22.x.x
10.x.x
10.x.x
0.x.x

Wichtig ist: nodejs liegt in /usr/bin node liegt in /usr/bin npm liegt in /usr/bin npx liegt in /usr/bin corepack liegt in /usr/bin und die Versionsnummern von nodejs und node sowie von npm und npx stimmen jeweils überein.

2 - Backup

iobroker backup

• alternative Möglichkeiten

3 - Adapter aktualisieren

• Anleitung dazu findet man unter Adapter verwalten

iob update

4 - ioBroker stoppen

iobroker stop

5 - ioBroker Prozesse prüfen

ps aux | grep 'io\|PID'

• und

ps aux | grep 'backup\|PID'

• falls noch Prozesse laufen

sudo kill -9 [PROZESS-ID]

Oder um alle ioBroker-Prozesse zu beenden:

sudo pkill -f iobroker
sudo pkill -f "io\."

6 - Node.JS Update

Methode A: ioBroker eigener Update-Befehl (Empfohlen für 2025)

# Direktes Update auf empfohlene Version (22.x)
iob nodejs-update

# Oder spezifische Version
iob nodejs-update 22

Methode B: NodeSource Repository

• Details zu Node.js

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

• Für andere Node.js Versionen einfach in der URL die 22 durch die andere Versionsnummer ersetzen.

!> Stand Oktober 2025 ist die Version 22.x von Node.js für ioBroker empfohlen!

!> Ungerade Node.js Versionen dürfen nicht verwendet werden.

!> Node.js 18.x ist End-of-Life (seit April 2025) und sollte nicht mehr verwendet werden.

7 - Version/Pfad kontrollieren

type -p nodejs node npm npx corepack && nodejs -v && node -v && npm -v && npx -v && corepack -v

8 - iobroker fixer ausführen

iobroker fix

9 - ioBroker starten

iobroker start

Anleitung für Windows

Node.js wird durch die Ausführung des Windows Installers aktualisiert.

Empfohlene Schritte für Windows (2025):

1. Aktuellen Node.js Windows Installer von nodejs.org herunterladen (Version 22.x LTS)
2. ioBroker stoppen über Dienste-Verwaltung oder Kommandozeile
3. Installer ausführen (automatisches Update)
4. ioBroker Fixer ausführen: iobroker fix
5. ioBroker starten

Alternative für Windows: Windows Subsystem for Linux (WSL2) mit Ubuntu und dann die Linux-Anleitung befolgen.

Anleitung für Docker

• Node.js wird in der Regel durch ein Update des Containers auf eine neue Version des Docker Image durchgeführt.
• Eine detaillierte Vorgehensweise, sowie weitere Details zum iobroker container ist bei buanet zu finden.

Problemlösung

manueller Rebuild

• Hierzu gibt es

iobroker rebuild

• falls das nicht reicht

iobroker rebuild --install

• einfach manuell an der Shell ausführen. Damit dürfte idealerweise alles automatisiert erledigt sein.

Dieser Befehl führt eine komplette Neuinstallation aller Node-Module durch und sollte die meisten Probleme nach einem Node.js Update lösen.

Häufige Probleme (2025)

"nodejs is NOT correctly installed"

# Lösung: Fixer ausführen
iobroker fix

# Falls das nicht hilft, Node.js neu installieren
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

NPM-Fehler nach Update

# NPM Cache leeren
npm cache clean --force

# Node modules neu installieren
cd /opt/iobroker
rm -rf node_modules
npm install

Adapter funktionieren nach Update nicht

# Einzelne Adapter neu installieren
iob install [ADAPTER-NAME]

# Oder alle Adapter rebuilden
iobroker rebuild --install

Permission-Probleme

# Berechtigungen korrigieren (Linux)
sudo chown -R iobroker:iobroker /opt/iobroker
iobroker fix

Diagnose-Befehle

# Umfassende Systemdiagnose
iob diag

# Node.js Installation prüfen
which node
which npm
ls -la $(which node)
node -v
npm -v

# ioBroker Status
iob status
iob list instances

?> Solange js-Controller kleiner Version 4, muss auch bei einem Node.js Update innerhalb einer Major Version, der ioBroker fixer ausgeführt werden.
Mit dem zukünftigen js-Controller in Version 4 werden Rebuild's vollautomatisch gehändelt.