Profi · Kapitel 2 von 4
ioBroker: Installation & erste Schritte
Vom Installer-Script bis zum ersten Adapter: Wie du ioBroker auf Linux einrichtest und dein Smart Home startest.
Lesezeit: ~3 MinAktualisiert 21. Juli 2026
Affiliate-Links: Als Amazon-Partner verdiene ich an qualifizierten Verkäufen — für dich bleibt der Preis gleich.
Das Wichtigste in Kürze
3 Kernaussagen für Schnellleser
ioBroker installierst du per Script auf Linux — Raspberry Pi OS, Debian oder Ubuntu. Der Installer richtet Node.js, ioBroker und einen systemd-Dienst ein; danach erreichst du die Admin-UI auf Port 8081. Dieser Artikel führt durch Script, MQTT-Broker und die ersten Adapter — VIS und Blockly kommen als nächste Schritte.
- ioBroker per Installer-Script auf Raspberry Pi OS oder Debian — kein dediziertes OS-Image nötig.
- Admin-UI auf Port 8081, dann MQTT-Broker und optional Zigbee2MQTT als erste Adapter.
- Adapter einzeln installieren und testen — VIS-Dashboard kommt, wenn die Geräte laufen.
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.
20 MinVom Script bis zur Admin-UI
600+Verfügbare Adapter
0 €/MonatKeine Cloud-Abos nötig
Das Wesentliche in Kürze
ioBroker installierst du per Installer-Script auf Linux — danach Admin-Adapter, MQTT und optional Zigbee2MQTT einrichten. Wer noch zwischen ioBroker und openHAB schwankt, liest den Vergleich. Die Schritt-für-Schritt-Installation folgt darunter.
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.
Häufig gestellte Fragen
Brauche ich Docker für ioBroker?
Nein — das Installer-Script auf bare-metal Linux ist der schnellste Einstieg. Docker lohnt sich später für einfachere Updates und Backups.
Welche Adapter installiere ich zuerst?
Admin ist schon da. Als Nächstes MQTT-Broker (mqtt.0) und optional Zigbee2MQTT — damit erreichst du Shelly, ESPHome und die meisten Funkgeräte.
Läuft ioBroker auf dem Raspberry Pi?
Ja — Raspberry Pi OS Lite plus Installer-Script reicht für 20–30 Geräte. Bei vielen Kameras oder schweren Adaptern ist ein Mini-PC angenehmer.
Passende Tools