Install ioBroker
ioBroker is a server. It runs around the clock, waits for events, and controls devices – even when no one is using it. Therefore, the installation consists of two decisions: where it should run and how it should be installed there.
This chapter goes through both of them in order.
The path through this chapter
- Requirements - what the system must have: RAM, space, operating system.
- Hardware - which device makes sense and what pitfalls to watch out for.
- The installation itself, depending on the chosen method (see below).
- Update - something that needs to be done regularly later on.
The routes at a glance
| Away | For what | Expense |
|---|---|---|
| Linux | The typical scenario: Debian, Ubuntu, Raspberry Pi OS. One command, done. | small amount |
| docker | If a Docker host or NAS is already available. | medium |
| Proxmox | When ioBroker is to run on a server alongside other services. | higher |
| Windows | If no Linux device is available. | small amount |
| macOS | For development and testing purposes only. | - |
For starters: Linux without any intermediate layers. Debian, Ubuntu, or Raspberry Pi OS in the server version, with the installation script on top. Each additional layer—Docker, virtualization—brings its own quirks that can stand between the problem and the solution in case of an error. Migrating is always possible later; a backup can be transferred from any of these paths to any other.
The installation command
On all Linux systems, it is the same single command:
curl -sLf https://iobroker.net/install.sh | bash -
It downloads missing packages, installs a suitable Node.js version, and configures the user.iobroker It connects and sets up the service. Node.js does not need to be installed manually beforehand.
The script will run as a normal user , not as a user account.root and not withsudo The user under whose account it runs manages the system later. Details can be found under Linux .
Finished Images
For Raspberry Pi and some single-board computers, there used to be ready-made images with ioBroker pre-installed. These are no longer maintained – the operating systems they contained have lacked security support for years. The current method is to install a current operating system yourself, then run the installation script.
After installation
The interface can be accessed in the browser athttp://<adresse-des-servers>:8081 From there, we continue:
- Admin interface - how the administration is structured
- Adapters and instances - how devices and services are connected
- Backup - set up the first backup before the initial configuration has taken any work.
If it doesn't work
- ioBroker is no longer working
- Adapter error
- The command
iob diagsummarizes the state of the system and is the first thing people ask about in the forum .