ioBroker

ioBroker ist eine quelloffene Integrationsplattform für Smart Home und IoT, die im deutschsprachigen Raum besonders stark verbreitet ist. Statt sich auf einen Hersteller oder ein Protokoll festzulegen, führt ioBroker Geräte, Cloud-Dienste und Bussysteme über sogenannte Adapter in einem einheitlichen Datenmodell zusammen. In dieser Anleitung erfährst du, was ioBroker ausmacht, wofür es sich eignet und wie du es sauber als Docker-Container mit persistentem Datenverzeichnis betreibst.

Was ist ioBroker?

ioBroker ist eine auf Node.js basierende Open-Source-Plattform, die heterogene Geräte und Dienste zu einem zentralen Smart-Home-System verbindet. Jede Anbindung erfolgt über einen Adapter, der ein Protokoll oder einen Dienst (etwa Zigbee, KNX, MQTT, Modbus oder eine Hersteller-Cloud) in das interne Objekt- und State-Modell von ioBroker übersetzt. Auf diesem gemeinsamen Datenmodell setzen dann Automatisierungen, Skripte und Visualisierungen auf, sodass Geräte unterschiedlichster Hersteller herstellerneutral zusammenspielen.

Wofür eignet sich ioBroker?

Herstellerübergreifende Integration. – bringt Geräte und Protokolle verschiedener Anbieter in ein einheitliches System, statt mehrere getrennte Apps zu betreiben.

Automatisierung und Logik. – über Blockly, JavaScript oder weitere Adapter lassen sich Regeln, Zeitpläne und ereignisbasierte Abläufe umsetzen.

Visualisierung und Dashboards. – mit VIS und ähnlichen Adaptern baust du eigene Bedienoberflächen, die auf eigenen Ports erreichbar sind.

Datenanbindung und Industrie/OT-Nähe. – durch Adapter für MQTT, Modbus oder InfluxDB eignet sich ioBroker auch für IoT- und einfache OT-Szenarien mit Logging und Weiterleitung.

Zentrale Konzepte

Adapter. – eigenständige Prozesse, die ein Gerät, Protokoll oder einen Dienst anbinden; sie werden über die Admin-Oberfläche installiert und konfiguriert.

Objekte und States. – Objekte beschreiben die Struktur (Geräte, Kanäle, Datenpunkte), States halten die aktuellen Werte; dieses Modell ist das Herzstück von ioBroker.

Admin-Oberfläche. – die zentrale Weboberfläche auf Port 8081, über die du Adapter, Instanzen, Objekte und Skripte verwaltest.

Persistenz. – die gesamte Konfiguration, alle Adapter und Daten liegen unter /opt/iobroker; dieses Verzeichnis muss zwingend dauerhaft erhalten bleiben.

Installation mit Docker

Für den Betrieb hat sich das offizielle Community-Image buanet/iobroker etabliert. Der einzig wirklich persistente Pfad ist /opt/iobroker – dort liegen die komplette ioBroker-Installation, alle Adapter, das Objekt-/State-Modell sowie deine Konfiguration. Diesen Pfad legen wir auf ein benanntes Volume (iobroker_data), damit Updates und Neustarts des Containers die Daten nicht verlieren. Wichtig: Für den Dauerbetrieb empfiehlt die offizielle Doku ausdrücklich, NICHT den latest-Tag zu verwenden, sondern einen auf die Major-Version gepinnten Tag (z. B. latest-v11), damit nicht versehentlich ein Major-Update mit Breaking Changes eingespielt wird. Als Netzwerk reicht für die meisten Adapter der Standard-Bridge-Modus mit explizit gemappten Ports; nur für Adapter, deren Geräte-Erkennung (Discovery) auf Multicast/Broadcast angewiesen ist, wird zusätzlich der Host-Netzwerkmodus (oder MACVLAN) benötigt.

1docker run -d \
2  --name iobroker \
3  --hostname iobroker \
4  -p 8081:8081 \
5  -e TZ=Europe/Zurich \
6  -e LANG=de_DE.UTF-8 \
7  -e SETUID=1000 \
8  -e SETGID=1000 \
9  -v iobroker_data:/opt/iobroker \
10  --restart unless-stopped \
11  buanet/iobroker:latest-v11

Oder als wiederverwendbare docker-compose.yml:

1services:
2  iobroker:
3    # Major-Version pinnen statt 'latest' (Breaking-Change-Schutz)
4    image: buanet/iobroker:latest-v11
5    container_name: iobroker
6    hostname: iobroker
7    ports:
8      - "8081:8081"   # Admin-Oberflaeche
9    environment:
10      TZ: Europe/Zurich
11      LANG: de_DE.UTF-8
12      SETUID: "1000"
13      SETGID: "1000"
14    volumes:
15      - iobroker_data:/opt/iobroker
16    restart: unless-stopped
17
18# Hinweis: Fuer Adapter mit Geraete-Discovery (Multicast/Broadcast)
19# stattdessen 'network_mode: host' setzen und den ports-Block entfernen.
20
21volumes:
22  iobroker_data:

Nach dem Start braucht der erste Lauf etwas Zeit, da die Installation initialisiert wird. Prüfe danach die Admin-Oberfläche und den Container-Status:

1# Container-Status pruefen
2docker ps --filter name=iobroker
3
4# Logs des Erststarts beobachten
5docker logs -f iobroker
6
7# Admin-Oberflaeche im Browser oeffnen
8# http://SERVER-IP:8081

Fazit

ioBroker ist eine flexible, herstellerneutrale Drehscheibe für Smart Home und IoT: Über Adapter bindest du nahezu beliebige Geräte und Dienste an ein gemeinsames Objekt- und State-Modell an und automatisierst, steuerst und visualisierst sie zentral. Im Docker-Betrieb sind drei Dinge entscheidend – das Datenverzeichnis /opt/iobroker als benanntes Volume zu persistieren, einen auf die Major-Version gepinnten Image-Tag (z. B. latest-v11) statt latest zu verwenden und das Netzwerk passend zu wählen (Bridge mit Port-Mapping als Standard, Host-Modus nur für Adapter mit Multicast/Broadcast-Discovery). Damit hast du eine wartbare Basis, die du um MQTT-Broker, InfluxDB oder Grafana zu einem vollständigen IoT-Stack erweitern kannst.