Zum Inhalt

Thread Border Router in Home Assistant sicher einrichten

Veröffentlicht am 9. September 2026 · Geschätzte Lesezeit: 8 Minuten

Mit einem Thread Border Router verbindet Home Assistant stromsparende Thread-Geräte mit deinem lokalen IP-Netz. Die OpenThread-Border-Router-App nutzt dafür ein kompatibles Funkmodul als Radio Co-Processor; Matter übernimmt anschließend die eigentliche Gerätesteuerung.[2][4] Für Backup, Einrichtung und einen ersten Matter-over-Thread-Test solltest du etwa 30 bis 60 Minuten einplanen.

Voraussetzungen

  • Home Assistant OS mit Administratorzugang und allen aktuellen Updates
  • Home Assistant Yellow, Connect ZBT-1/SkyConnect, Connect ZBT-2 oder ein kompatibles 802.15.4-Funkmodul mit OpenThread-RCP-Firmware[2]
  • Ein USB-Verlängerungskabel bei einem externen Funkmodul sowie ein Android-Smartphone oder iPhone mit aktueller Home-Assistant-Companion-App
  • Ein Matter-over-Thread-Testgerät mit sicher aufbewahrtem QR- oder Zahlencode und ein aktuelles vollständiges Home-Assistant-Backup

1. Funkmodul und bisherigen Einsatz prüfen

Kontrolliere zuerst, welches Funkmodul du für Thread verwenden möchtest. Home Assistant Yellow, Connect ZBT-1 und Connect ZBT-2 können mit der OpenThread-Border-Router-App als Thread-Radio arbeiten.[2] Ein Funkmodul mit reiner Zigbee-Firmware ist jedoch noch kein einsatzbereites OpenThread-RCP.

Prüfe unter Einstellungen → Geräte & Dienste, ob das ausgewählte Radio derzeit von Zigbee Home Automation oder einer anderen Zigbee-Lösung verwendet wird. Soll das bestehende Zigbee-Netz weiterlaufen, migriere es nach der Dokumentation deiner Zigbee-Integration zuerst auf ein anderes Funkmodul. Die offizielle Yellow-Anleitung warnt ausdrücklich, dass die dedizierte Thread-Firmware die Zigbee-Funktion dieses Radios ersetzt.[3]

Nicht ohne Zigbee-Migration umstellen

Verwende ein produktives Zigbee-Radio nicht gleichzeitig als dediziertes Thread-Radio. Ohne vorherige Migration können deine Zigbee-Geräte und deren Automationen ausfallen. Kaufe im Zweifel ein zweites kompatibles Funkmodul für Thread.

2. Backup und Rückweg vorbereiten

Öffne Einstellungen → System → Backups, erstelle ein vollständiges Backup und lade zusätzlich eine Kopie auf einen zweiten, geschützten Speicherort herunter. Notiere außerdem:

  • Modell und bisherige Aufgabe des Funkmoduls
  • aktuell verwendete Zigbee- oder Thread-Firmware
  • den in Home Assistant angezeigten Gerätepfad
  • vorhandene Thread-Netzwerke und deren bevorzugten Status

Sichere Thread-Zugangsdaten niemals in einem öffentlichen Screenshot oder Supportbeitrag. Der sichere Rückweg besteht zunächst darin, die OpenThread-Border-Router-App zu stoppen und das Radio wieder seiner vorherigen Aufgabe zuzuweisen. Wurde die Firmware umgestellt, spiele ausschließlich die zum exakten Modell passende Hersteller-Firmware zurück. Stelle das Home-Assistant-Backup nur wieder her, wenn auch die Konfiguration auf den vorherigen Stand zurückmuss.

3. Vorhandene Thread-Netzwerke erfassen

Öffne Einstellungen → Geräte & Dienste und suche nach der Integration Thread. Öffne deren Konfiguration und notiere, ob dort bereits Netze von Home Assistant, Apple, Google oder anderen Border Routern erscheinen.

Ein Border Router leitet IPv6-Verkehr zwischen Thread und Ethernet beziehungsweise WLAN weiter; er ist nicht selbst der Matter-Controller.[4] Mehrere Border Router können grundsätzlich dasselbe Thread-Netz erweitern, doch getrennte Netze besitzen unterschiedliche Zugangsdaten. Lösche deshalb kein vorhandenes Netz und setze keine bereits verbundenen Geräte zurück, nur weil mehrere Einträge sichtbar sind.

Entscheide jetzt:

  • Noch kein Thread-Netz: Home Assistant darf ein neues Netz anlegen.
  • Vorhandenes Netz: Behalte dessen Zugangsdaten und importiere sie später über die Companion-App, bevor du es als bevorzugt festlegst.

4. Funkmodul zuverlässig anschließen

Stecke ein externes USB-Funkmodul über ein kurzes USB-Verlängerungskabel an das Home-Assistant-System. Das hält das 2,4-GHz-Radio von USB-3-Geräten, SSDs und Metallflächen fern. Verwende keinen instabilen USB-Hub.

Die offizielle App-Dokumentation erwartet eine zuverlässige lokale Verbindung zwischen OpenThread Border Router und RCP, beispielsweise über UART oder SPI. Ein über TCP/IP entfernt angebundenes RCP kann bei Verbindungsabbrüchen veraltete Routen hinterlassen und Thread-Geräte zeitweise unerreichbar machen.[2] Diese Anleitung verwendet deshalb nur ein lokal angeschlossenes oder im Yellow integriertes Radio.

5. Dedizierte Thread-Firmware aktivieren

Bei Home Assistant Yellow öffnest du Einstellungen → System → Hardware → Konfigurieren → Zwischen Zigbee- und Thread-Firmware wechseln. Wähle Als Thread-Adapter verwenden. Home Assistant installiert dabei die OpenThread-Border-Router-App und zeigt anschließend die Integrationen OpenThread Border Router und Thread an.[3]

Bei Connect ZBT-1/SkyConnect oder Connect ZBT-2 folgst du dem in Home Assistant angebotenen Thread-Einrichtungsdialog für genau dieses Modell. Die offizielle App unterstützt diese Radios und kann die passende Firmware über Home Assistant bereitstellen.[2] Bei einem anderen Funkmodul musst du vorab nach Herstelleranleitung eine aktuelle OpenThread-RCP-Firmware installieren und die dazugehörige Baudrate notieren.

Nur passende Firmware verwenden

Unterbrich keinen Firmware-Wechsel und flashe keine Datei für ein ähnliches Modell. Prüfe Modell, Hardware-Revision und Protokoll vor der Bestätigung. Eine falsche Firmware kann das Radio unbrauchbar machen.

6. OpenThread-Border-Router-App konfigurieren

Falls die App nicht bereits durch den Hardwaredialog installiert wurde, öffne Einstellungen → Apps → App installieren, suche nach OpenThread Border Router und installiere sie.[2]

Öffne anschließend den Reiter Konfiguration. Wähle unter Gerät den erkannten seriellen Anschluss des vorgesehenen Thread-Radios. Für Home Assistant Yellow nennt die offizielle App-Dokumentation den internen Anschluss /dev/ttyAMA1; bei USB-Adaptern kann der Pfad anders lauten.[2]

Trage die vom Radiohersteller angegebene Baudrate ein. Fehlt diese Angabe, nennt Home Assistant 460800 nur als möglichen Versuchswert; der korrekte Wert hängt von der Firmware ab. Ändere Hardware-Flusskontrolle nur nach Herstellerangabe oder wenn App-Protokoll und offizielle Fehlerhilfe darauf hinweisen.

Lasse die Firewall aktiviert, damit die von der App vorgesehenen Filter unnötigen eingehenden Verkehr blockieren.[2][4] Aktiviere NAT64 nur, wenn ein konkretes Thread-Gerät IPv4-Ziele erreichen muss. Der experimentelle Beta-Modus und die entfernte Netzwerk-RCP-Verbindung bleiben für diese Einsteigerinstallation deaktiviert.[2]

7. App starten und Integrationen prüfen

Speichere die Konfiguration, starte die App und öffne Protokoll. Warte, bis die Initialisierung abgeschlossen ist. Ein fortlaufender Neustart, ein nicht erreichbares Radio oder wiederholte serielle Verbindungsfehler sind kein erfolgreicher Start.

Öffne danach Einstellungen → Geräte & Dienste. Die OpenThread-Border-Router-Integration wird bei der offiziellen App normalerweise automatisch eingerichtet.[1][2] Zusätzlich muss die Integration Thread vorhanden sein und das neue Home-Assistant-Thread-Netz anzeigen.[2]

Musst du einen bereits separat laufenden OpenThread Border Router manuell einbinden, verlangt die Integration dessen lokale REST-API-Adresse mit Host und Port 8081; die offizielle Integration verwendet dafür im lokalen Netz HTTP.[1] Öffne diesen Port niemals am Internet. Die manuelle Variante ist ein fortgeschrittener Sonderfall und nicht der Standardweg dieser Anleitung.

8. Bevorzugtes Netz und Smartphone abgleichen

Öffne die Konfiguration der Thread-Integration. Bei einer neuen Installation sollte das von Home Assistant angelegte Netz mit Home-Assistant-Logo erscheinen. Lege nur ein Netz als bevorzugt fest, dessen Zugangsdaten Home Assistant tatsächlich kennt.

Existiert bereits ein Apple- oder Google-Thread-Netz, importiere dessen Zugangsdaten über die Thread-Konfiguration in der Home-Assistant-Companion-App. Verwende dafür ein iPhone für ein Apple-Netz beziehungsweise ein Android-Gerät für ein Google-Netz. Aktualisiere danach die Ansicht und wähle das gewünschte vorhandene Netz als bevorzugt. So vermeidest du ein unnötiges zweites Funknetz.

Bei einem neuen Home-Assistant-Netz synchronisierst du die Thread-Zugangsdaten in der Companion-App auf das Smartphone. Bestätige nur die Übertragung zwischen deinen eigenen Geräten und veröffentliche weder Dataset noch Zugangsdaten.

Thread-Zugangsdaten geheim halten

Die Zugangsdaten funktionieren ähnlich wie ein WLAN-Kennwort. Teile sie nicht in Logs, Screenshots, QR-Codes, Backups ohne Verschlüsselung oder öffentlichen Repositories.

9. Matter-over-Thread-Gerät kontrolliert testen

Verwende jetzt ein unkritisches Matter-over-Thread-Gerät, zum Beispiel eine schaltbare Teststeckdose ohne angeschlossene Last. Prüfe auf Verpackung oder Gerät sowohl das Matter- als auch das Thread-Logo. Bewahre QR- und Zahlencode geschützt auf.

Öffne auf dem Smartphone die Home-Assistant-Companion-App, gehe zu Einstellungen → Matter → Gerät hinzufügen und scanne den Einrichtungscode. Halte Smartphone und Testgerät während der Kopplung in der Nähe des Border Routers. Bluetooth überträgt beim Einrichten die Netzwerkdaten; anschließend läuft die lokale Verbindung über Thread.

Der aktuelle Praxisbericht für Home Assistant Container bestätigt, dass ein bisher für Zigbee verwendeter ZBT-1 vor dem Thread-Einsatz freigegeben und auf OpenThread RCP umgestellt werden muss.[5] Er nutzt allerdings einen privilegierten Host-Network-Container und ist deshalb keine Vorlage für diese Home-Assistant-OS-Anleitung. Das öffentlich auffindbare Video Setup Matter Over Thread In Home Assistant zeigt Backup, Radio-Umstellung, OTBR und Gerätekopplung mit anderer Hardware; verwende es nur als visuellen Praxisvergleich und übernimm keine gerätespezifischen Werte.[6]

10. Risiken und typische Fehler beheben

  • Radio fehlt in der App: Prüfe USB-Kabel, Verlängerung, Stromversorgung und ob nicht noch eine Zigbee-Integration auf das Gerät zugreift.
  • App startet immer wieder neu: Prüfe Gerätepfad, RCP-Firmware, Baudrate und danach die Hardware-Flusskontrolle.[2]
  • Thread-Netz erscheint nicht: Warte nach dem App-Start, kontrolliere das App-Protokoll und starte nicht gleichzeitig mehrere OTBR-Instanzen für dasselbe Radio.
  • Matter-Kopplung bricht ab: Prüfe Bluetooth, Kopplungsmodus, synchronisierte Thread-Zugangsdaten sowie die Erreichbarkeit von Smartphone, Home Assistant und Border Router.
  • Gerät bleibt unerreichbar: Prüfe, ob IPv6 und mDNS im Heimnetz funktionieren und ob VLAN-, Multicast- oder Firewall-Regeln den lokalen Verkehr blockieren. Thread und Matter benötigen lokale IPv6-Kommunikation.[4]
  • Zigbee-Geräte sind ausgefallen: Stoppe die Thread-Einrichtung und führe den vorbereiteten Rückweg aus. Weise das Radio nicht beiden Protokollen gleichzeitig zu.
  • Viele Funkfehler: Vergrößere den Abstand zu USB-3-Geräten und 2,4-GHz-WLAN-Sendern. Ändere den Thread-Kanal nicht unüberlegt in einem bereits produktiven Netz.
  • REST-API von außen erreichbar: Entferne sofort die Portfreigabe. Die lokale HTTP-API gehört nicht ins Internet.[1]

Ein Border Router erweitert die lokale Netzverbindung und ist deshalb Teil deiner Sicherheitsgrenze. Halte Home Assistant und Apps aktuell, lasse die OTBR-Firewall aktiv und erlaube zwischen VLANs nur den tatsächlich benötigten lokalen IPv6- und Discovery-Verkehr. Nutze die erste Installation nicht für Türschlösser, Alarmtechnik, Heizgeräte oder andere sicherheitskritische Funktionen.

11. Rückweg und Wiederherstellung prüfen

Schlägt die Einrichtung fehl, setze das Matter-Gerät nicht sofort auf Werkseinstellungen zurück. Stoppe zuerst die OpenThread-Border-Router-App und prüfe, ob du nur Gerätepfad, Baudrate oder Flusskontrolle korrigieren musst.

Möchtest du die Änderung vollständig zurücknehmen, entferne zuerst das neu gekoppelte Testgerät sauber aus der Matter-Integration. Stoppe danach die OpenThread-Border-Router-App. Weise dem Radio nur dann wieder Zigbee-Firmware zu, wenn du das in Schritt 1 dokumentierte ursprüngliche Zigbee-Netz oder eine vorbereitete Migration verwendest. Spiele bei beschädigter Home-Assistant-Konfiguration das vollständige Backup aus Schritt 2 zurück.

Prüfe nach dem Rückweg, dass bestehende Zigbee- oder Thread-Geräte wieder erreichbar sind. Entferne keine bekannten Thread-Zugangsdaten und lösche kein produktives Thread-Netz, solange noch Geräte damit verbunden sind.

Sources

[1] https://www.home-assistant.io/integrations/otbr — Home Assistant: OpenThread Border Router [2] https://github.com/home-assistant/addons/blob/master/openthread_border_router/DOCS.md — Home Assistant: OpenThread Border Router App [3] https://support.nabucasa.com/hc/articles/25742476767517 — Nabu Casa: Switching Home Assistant Yellow from Zigbee to Thread [4] https://openthread.io/guides/border-router — OpenThread: Border Router [5] https://community.home-assistant.io/t/setting-up-thread-on-a-zbt-1-with-ha-container/1012601 — Home Assistant Community: Thread on ZBT-1 with HA Container [6] https://youtube.com/watch?v=oULvL7jTRP0 — YouTube: Setup Matter Over Thread In Home Assistant

Fertig

Der Thread Border Router ist einsatzbereit, wenn die OpenThread-Border-Router-App ohne Neustartschleife läuft, beide Integrationen erreichbar sind, genau das gewünschte Thread-Netz bevorzugt wird und das Testgerät auch nach einem Home-Assistant-Neustart lokal reagiert. Schalte die gefahrlose Testfunktion zweimal, kontrolliere die Statusrückmeldung in Home Assistant und prüfe danach erneut App-Protokoll sowie Geräteverfügbarkeit.[1][2]