Tutorial: ioBroker installation on the Raspberry Pi
What is ioBroker and what is it used for?
ioBroker is a free open-source platform that connects different smart home systems and devices under one interface. So-called adapters can be used to integrate hundreds of systems, from Philips Hue and Zigbee devices to the Loxone Miniserver. The software runs on its own computer in the home network, often on a Raspberry Pi.
ioBroker is particularly suitable for DIY enthusiasts and tech fans who want to combine devices from different manufacturers into one overall system. The platform acts as the integration hub: adapters establish the connection to the individual systems, and visualisations and scripts take care of evaluation and automation. ioBroker is also interesting in combination with Loxone, for example to integrate devices for which there is no direct Loxone interface. Installation on a Raspberry Pi takes about an hour, and our step-by-step guide on this page takes you through the complete process.
This tutorial shows a step-by-step installation of ioBroker on a Raspberry Pi. The whole installation can be done within an hour if you have prepared everything accordingly.
Requirements:
- Raspberry Pi 3 or newer (incl. power supply)
- Micro SD card (at least 8 GB)
- PC/Mac for writing the SD card for the first time
- if necessary, a micro SD to SD adapter
- Display with HDMI connection
- HDMI cable
- USB keyboard
Questions, comments and suggestions are welcome under the YouTube video.
Step 1: download Raspbian Buster Lite
Download “Raspbian Buster Lite” using the “Download ZIP” button.
Link: www.raspberrypi.org/downloads/raspbian
Step 2: download balenaEtcher
With this free tool we transfer ready-made images to the SD card. Stress-free and without formatting the SD card first.
Link: www.balena.io/etcher
Step 3: install balenaEtcher
Install the downloaded file, i.e. double-click the balenaEtcher download and follow the installation instructions.
Step 4: writing the SD card for the first time
Connect the micro SD card to your PC/Mac and start balenaEtcher.
Select the image (unzip the ZIP file first), select the SD card and start the flash process.
Step 5: connecting the Raspberry Pi
Now insert the finished micro SD card into the underside of the Raspberry Pi.
Connect a display via HDMI.
Connect a USB keyboard.
Connect a network cable (connection to the router required, DHCP active).
Connect the power supply.
The Raspberry Pi now starts automatically.
Step 6: first login on the command line
Here we have to pay attention for the first time: the Raspbian image comes with an American keyboard layout. If you use a German keyboard, Z and Y are swapped.
The login user is: pi
The initial password is: raspberry (with a German keyboard you have to type a Z as the last letter, otherwise the login fails).
Step 7: change the keyboard layout (e.g. to German)
Enter “sudo raspi-config” (on a German keyboard with the American layout, the hyphen is on the ß key). Follow these instructions here…
Step 8: install updates on the Raspberry Pi
Enter “sudo apt-get update && sudo apt-get upgrade”.
Wait until the process has finished.
Now a restart is due – enter “sudo reboot”.
Log in again after the restart.
Step 9 (optional): set a fixed IP address
Alternatively, you can tick the option for the Raspberry Pi in your router, “Always assign this device the same IP address” (or similar)
Enter “sudo nano /etc/dhcpcd.conf”.
The editor opens the current network configuration.
Remove the hash in front of “interface eth0”
Remove the hash in front of “static ip_address=192.168.0.4/24
(you can enter your own IP address there – but please make sure that /24 remains at the end)
Remove the hash in front of “static routers=192.168.0.1” and change the IP to your router’s IP address.
Remove the hash in front of “static domain_name_servers=192.168.0.1” (the same IP address as your router’s should be entered here)
Press CTRL+X to save.
Confirm this and press ENTER.
Restart – enter “sudo reboot” and log in again afterwards.
Step 10: installing ioBroker
Enter “curl -sL https://iobroker.net/install.sh | bash -“.
This command starts the complete ioBroker installation.
At the end of the installation, the URL at which ioBroker can be reached is displayed.
Step 11: opening ioBroker via the web interface
Go to your PC/Mac and open the address that was shown at the end of the setup. Follow the instructions in ioBroker (licence terms, basic settings)
Step 12 (optional): change the password of the user “pi”
Change the password of the user “pi” by entering “sudo raspi-config” again and selecting the first item.
Follow the instructions on the screen.
That’s it! Have fun with it!
Frequently asked questions about ioBroker
What hardware do I need for ioBroker?
For ioBroker, a Raspberry Pi 3 or newer with power supply and a micro SD card with at least 8 GB is sufficient. For the initial setup you also need a PC or Mac to write the SD card, as well as a display with HDMI connection, an HDMI cable and a USB keyboard.
Is ioBroker free?
Yes, ioBroker is free open-source software and can be used without licence fees. You only pay for the hardware, such as the Raspberry Pi and the memory card. The numerous adapters for connecting different systems are also available free of charge.
Does ioBroker work with Loxone?
Yes, ioBroker can be connected to the Loxone Miniserver via a suitable adapter. This is particularly interesting if you want to integrate devices for which there is no direct Loxone interface. This lets you extend your Loxone system with components from other manufacturers.
How do I install ioBroker on the Raspberry Pi?
First the operating system is written to the micro SD card and the Raspberry Pi is started. Then Node.js and ioBroker are installed via the command line, after which the interface can be reached in the browser. The complete installation takes about an hour, and our step-by-step guide on this page takes you through every step.