ioBroker: Installation & erste Schritte

Warum ioBroker?

ioBroker ist eine modulare IoT-Plattform mit starker deutscher Community. Über 600 Adapter verbinden Zigbee, Homematic, Shelly, MQTT und viele DACH-spezifische Dienste – alles lokal auf deiner Hardware, ohne Cloud-Zwang.

Die Konfiguration läuft primär über die Web-UI. Blockly ermöglicht visuelle Automationen ohne Code. Wer JavaScript kennt, kann später eigene Skripte schreiben.

Hardware-Anforderungen

Raspberry Pi 4 oder Mini-PC

ioBroker hat kein dediziertes OS-Image wie Home Assistant. Du installierst es auf einem bestehenden Linux-System – Raspberry Pi OS, Debian oder Ubuntu. Ein Raspberry Pi 4🛒(öffnet in neuem Tab) mit 2–4 GB RAM reicht für den Einstieg; ein gebrauchter Mini-PC bietet mehr Reserve für viele Adapter.

Docker (optional)

Viele Nutzer betreiben ioBroker als Docker-Container – einfache Updates und saubere Backups. Für den ersten Kontakt ist das Installer-Script auf bare-metal Linux oft schneller.

Netzwerk und Zubehör

Ethernet-Kabel. Offizielles Netzteil. Optional: Zigbee-Stick (Sonoff Dongle🛒(öffnet in neuem Tab) Plus) für Zigbee-Geräte ohne Hersteller-Bridge.

Pro-Tipp

ioBroker und Home Assistant auf demselben Pi zu betreiben ist möglich, aber RAM-intensiv. Für den Start: ein System, eine Hardware – später kannst du per MQTT koppeln.

KI-generiert

Installation Schritt für Schritt

Linux vorbereiten

Installiere Raspberry Pi OS Lite oder Debian auf deinem Pi. Setze einen festen Hostnamen, aktualisiere das System (sudo apt update && sudo apt upgrade) und verbinde Ethernet.

Installer-Script ausführen

Als root oder mit sudo:

curl -sLf https://iobroker.net/install.sh | bash -

Das Script installiert Node.js, ioBroker und richtet einen systemd-Dienst ein. Nach 10–20 Minuten ist die Installation fertig.

Admin-UI öffnen

Öffne im Browser http://<deine-ip>:8081. Der Admin-Adapter ist bereits installiert – das ist die zentrale Verwaltungsoberfläche. Lege ein Admin-Passwort fest, wenn du dazu aufgefordert wirst.

Wusstest du schon?

ioBroker speichert jede Geräte-Eigenschaft als Datenpunkt mit eindeutiger ID. Du siehst sofort, welcher Sensor welchen Wert liefert – praktisch zum Debuggen.

Erste Schritte nach der Installation

MQTT-Broker einrichten

Viele Geräte (Shelly, ESPHome, Zigbee2MQTT) sprechen MQTT. Installiere den Adapter mqtt.0 über Adapter → Adapter hinzufügen. Starte den Broker, notiere Host und Port – meist localhost:1883.

Zigbee-Geräte anbinden

Installiere zigbee2mqtt oder den zigbee-Adapter, wenn du einen USB-Stick nutzt. Pairing läuft über die Adapter-Konfiguration. Details zu den wichtigsten Adaptern findest du im Artikel ioBroker: Die wichtigsten Adapter.

Erstes Dashboard (VIS)

Der vis-2-Adapter ermöglicht Drag-and-Drop-Dashboards. Installiere ihn, wenn du eine visuelle Oberfläche willst – kein Muss am ersten Tag, aber der natürliche nächste Schritt nach den ersten Geräten.

Pro-Tipp

Installiere Adapter einzeln und teste jeden, bevor du den nächsten hinzufügst. So findest du Fehler schneller als bei zehn parallelen Installationen.

Nächste Schritte

ioBroker läuft – als Nächstes: Adapter vertiefen, Blockly-Automationen bauen, VIS-Dashboard gestalten. Das deutsche Forum (forum.iobroker.net) und die Dokumentation auf iobroker.net helfen bei fast jedem Adapter.