Installation
Which Node.js version do I need?
ioBroker runs on Node.js. The LTS version Node.js 22 is recommended.
Odd version numbers must not be used (21, 23, 25…). These are development branches without long-term support.
On Debian, Ubuntu, and Raspberry Pi OS, the ioBroker installation script automatically installs Node.js. For manual installation:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
The installed version can be checked with:
node -v
npm -v
They both need to be compatible.nodeCurrent ,nodeNewest andnodeNewestNext If the Hosts tab shows discrepancies, an update is needed.
Details: Install Node.js
How do I install ioBroker?
The method depends on the operating system:
| system | Away |
|---|---|
| Linux (Debian, Ubuntu, Raspberry Pi OS) | The normal procedure. One command, done: Installation under Linux. |
| docker | If a Docker host or NAS is already available: Docker |
| Proxmox | If ioBroker is to run alongside other services: Proxmox |
| Windows | Windows |
| macOS | For testing and development purposes only: macOS |
Under Linux, the following is sufficient:
curl -sLf https://iobroker.net/install.sh | bash -
After that, the admin is underhttp://<IP-Adresse>:8081 reachable.
For those who are unsure: Debian without a graphical user interface on a mini-PC with an SSD is the path with the fewest surprises.
How do I update Node.js correctly?
Within a major version (e.g., from 22.9 to 22.11), a normal system update is sufficient:
sudo apt update && sudo apt upgrade
Upgrading to a major version (e.g., from 20 to 22) is a different matter. In this case, the modules must be rebuilt; otherwise, adapters will no longer start. This is handled by the command.iob nodejs-update .
!> Create a backup beforehand. And never skip a major version or switch to an odd-numbered version.
The full process is described under Update Node.js.
An update of ioBroker itself is different from an update of Node.js. For ioBroker, see Updating .