ioBroker: Die wichtigsten Adapter

Was ist ein ioBroker-Adapter?

Ein Adapter in ioBroker ist vergleichbar mit einem Plugin oder Add-on: Er erweitert die Kernfunktionalität um eine bestimmte Fähigkeit. Jeder Adapter kommuniziert mit einer Geräteklasse, einem Protokoll oder einem Dienst und stellt die Daten als Objekte und Zustände (States) im ioBroker-Objektbaum zur Verfügung. Alle Adapter werden über das Admin-Panel installiert und konfiguriert – du brauchst keine Kommandozeile.

Im ioBroker-Repository stehen über 500 offizielle Adapter bereit (Stand 06/2026). Achte auf den Status „stable" im Adapter-Verzeichnis. Adapter mit „beta"- oder „dev"-Status können Instabilitäten verursachen.

Die sechs Kern-Adapter im Detail

Nicht alle 500 Adapter sind gleich wichtig. Die folgenden sechs bilden das Rückgrat fast jeder ioBroker-Installation:

Admin – Das Kommandozentrum

Der Admin-Adapter ist das Webinterface, über das du ioBroker steuerst. Er ist bei jeder Installation vorinstalliert und lauscht standardmäßig auf Port 8081. Hier installierst du andere Adapter, legst Instanzen an, konfigurierst Objekte und verwaltest Benutzer. Ohne den Admin-Adapter kommst du nicht in ioBroker hinein – er ist das Fundament.

MQTT – Das Sprachrohr zwischen Systemen

Der MQTT-Adapter fungiert als Client oder Broker und erlaubt ioBroker, mit MQTT-fähigen Geräten und Systemen zu kommunizieren. In der Praxis verbindest du ihn mit einem Mosquitto-Broker und tauschst Daten mit Zigbee2MQTT, ESPHome-Geräten oder Home Assistant aus. Die Konfiguration verlangt die Broker-IP, den Port (meist 1883) und optional Zugangsdaten.

Zigbee – Smart-Home-Geräte kabellos steuern

Mit dem Zigbee-Adapter steuerst du Zigbee-Geräte direkt aus ioBroker heraus: Lampen, Steckdosen, Sensoren, Thermostate. Dafür brauchst du einen USB-Coordinator – aktuelle Empfehlungen sind der Sonoff Dongle Plus MG24🛒(öffnet in neuem Tab) oder das ConBee II🛒(öffnet in neuem Tab).

Die Platzierung des Sticks entscheidet über Reichweite und Stabilität: USB 3.0 erzeugt elektromagnetisches Rauschen im 2,4-GHz-Band. Stecke den Coordinator daher per deleyCON USB 2.0 Verlängerungskabel🛒(öffnet in neuem Tab) an einen USB-2.0-Port und platziere ihn frei auf einem Regal – nicht hinter dem Server versteckt. Falls nur USB-3.0-Ports vorhanden sind, ist eine 1–2 m lange USB-2.0-Verlängerung die einfachste Lösung.

VIS – Das Dashboard zum Anfassen

VIS (Visualisierung) ist der klassische ioBroker-Dashboard-Editor. Du ziehst Widgets per Drag-and-Drop auf eine Arbeitsfläche und verknüpfst sie mit ioBroker-Zuständen. Es gibt Dutzende Widget-Sets: einfache Schalter, Diagramme, Wetterkarten, Kameras.

VIS-2 oder VIS Classic? Für neue Setups empfiehlt sich VIS-2: modernes responsives Design, aktiv weiterentwickelt. VIS Classic ist stabiler und hat mehr verfügbare Widgets – sinnvoll für bestehende Projekte, die nicht migriert werden sollen. Eine Migration von Classic zu VIS-2 ist möglich, aber arbeitsaufwendig. Mehr zu Dashboard-Optionen im Artikel Dashboards bauen.

JavaScript / Blockly – Automatisierungen programmieren

Der JavaScript-Adapter bringt eine Skript-Engine in ioBroker. Du kannst Automatisierungen in JavaScript oder TypeScript schreiben, oder – für Einsteiger bequemer – mit Blockly grafisch zusammenklicken. Blockly-Blöcke decken alle gängigen Fälle ab: „Wenn Temperatur unter 18 Grad, dann Thermostat auf 20 stellen."

Device-Watcher – Den Gerätezustand überwachen

Der Device-Watcher Adapter überwacht alle Geräte auf Batteriestand, Verbindungszustand und Erreichbarkeit. Er meldet dir per Telegram, E-Mail oder Push, wenn ein Sensor nicht mehr antwortet oder die Batterie eines Fensterkontakts zur Neige geht. Halte passende CR2032-Knopfzellen🛒(öffnet in neuem Tab) griffbereit – die meisten Aqara- und Xiaomi-Sensoren nutzen diesen Typ und halten bei normalem Update-Intervall 6–12 Monate; der Device-Watcher meldet frühzeitig, wenn die Spannung unter 2,7 V fällt.

Pro-Tipp

Installiere den Device-Watcher früh – nicht erst, wenn du 50 Geräte hast und nicht mehr weißt, welche Batterie leer ist. Er erstellt automatisch eine Geräteliste mit allen relevanten Zuständen und warnt proaktiv.

Adapter installieren und konfigurieren

ioBroker läuft auf Linux – häufig auf einem Raspberry Pi 4🛒(öffnet in neuem Tab) mit High-Endurance-microSD🛒(öffnet in neuem Tab) oder auf einem Mini-PC. Die Installation eines Adapters erfolgt immer in denselben Schritten: Admin-Panel öffnen → „Adapter" klicken → Adapter im Katalog suchen → Plus-Symbol klicken. ioBroker lädt den Adapter herunter und erstellt automatisch eine Instanz.

• Repository wählen: Für den Produktivbetrieb nutze das „default"-Repository. Das „latest"-Repository enthält neuere Versionen, die aber weniger getestet sind.
• Instanz-Status prüfen: Grüner Punkt = Adapter läuft. Gelb = Startphase. Rot = Fehler. Prüfe das Log bei roten Instanzen.
• Logs lesen: Das Instanz-Log ist die erste Anlaufstelle bei Problemen. Filtere nach „error" und „warn".

Wusstest du schon?

Du kannst ioBroker-Adapter auch über die Kommandozeile installieren: iobroker add mqtt installiert den MQTT-Adapter ohne das Admin-Panel. Das ist nützlich, wenn du ioBroker headless (ohne grafische Oberfläche) einrichtest.

Häufige Fallstricke und wie du sie vermeidest

• Zu viele Adapter gleichzeitig: Installiere nicht 20 Adapter auf einmal. Manche Adapter benötigen einen Neustart des ioBroker-Controllers. Installiere nacheinander und prüfe nach jeder Installation, ob das System stabil läuft.
• Zigbee-Stick nicht erkannt: Prüfe unter iobroker list usb, ob der Stick erkannt wird. Bei Docker-Installationen musst du den USB-Stick explizit durchreichen. Wächst das Netzwerk, brauchen stromgespeiste Nous A1Z Zigbee Steckdose🛒(öffnet in neuem Tab) als Mesh-Router – sonst erreichen batteriebetriebene Sensoren den Coordinator nicht zuverlässig.
• Admin-Port belegt: Wenn Port 8081 bereits belegt ist, ändere den Port in der Admin-Konfiguration.
• Alte Adapter-Versionen: Halte deine Adapter aktuell. Viele Probleme lösen sich durch ein einfaches Update.

KI-generiert