Installation
Welche Node.js-Version brauche ich?
ioBroker läuft auf Node.js. Empfohlen ist die LTS-Version Node.js 22.
!> Ungerade Versionsnummern dürfen nicht verwendet werden (21, 23, 25 …). Das sind Entwicklungszweige ohne Langzeitunterstützung.
Unter Debian, Ubuntu und Raspberry Pi OS erledigt das Installationsskript von ioBroker Node.js gleich mit. Wer es von Hand macht:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
Prüfen lässt sich die installierte Version mit:
node -v
npm -v
Beide müssen zusammenpassen. Wenn nodeCurrent, nodeNewest und
nodeNewestNext im Reiter Hosts auseinanderlaufen, steht ein Update an.
Einzelheiten: Node.js installieren
Wie installiere ich ioBroker?
Der Weg hängt vom Betriebssystem ab:
| System | Weg |
|---|---|
| Linux (Debian, Ubuntu, Raspberry Pi OS) | Der Normalfall. Ein Befehl, fertig: Installation unter Linux |
| Docker | Wenn schon ein Docker-Host oder ein NAS vorhanden ist: Docker |
| Proxmox | Wenn ioBroker neben anderen Diensten laufen soll: Proxmox |
| Windows | Windows |
| macOS | Nur zum Ausprobieren und Entwickeln: macOS |
Unter Linux genügt:
curl -sLf https://iobroker.net/install.sh | bash -
Danach ist der Admin unter http://<IP-Adresse>:8081 erreichbar.
?> Wer sich unsicher ist: Debian ohne Oberfläche auf einem Mini-PC mit SSD ist der Weg mit den wenigsten Überraschungen.
Wie aktualisiere ich Node.js richtig?
Innerhalb einer Hauptversion (z. B. 22.9 auf 22.11) genügt das normale Systemupdate:
sudo apt update && sudo apt upgrade
Ein Wechsel der Hauptversion (z. B. von 20 auf 22) ist etwas anderes. Dabei
müssen die Module neu gebaut werden, sonst starten Adapter nicht mehr. Das
übernimmt der Befehl iob nodejs-update.
!> Vorher ein Backup anlegen. Und niemals eine Hauptversion überspringen oder auf eine ungerade Version wechseln.
Der vollständige Ablauf steht unter Node.js aktualisieren.
?> Ein Update von ioBroker selbst ist etwas anderes als ein Update von Node.js. Für ioBroker siehe Updaten.