HomeKit Bridge in Home Assistant einrichten: Was wirklich funktioniert

Kurzantwort

Die HomeKit Bridge macht Home-Assistant-Geräte in Apple Home sichtbar. Wie die Integration läuft, wo sie hakt und was die 150er-Grenze in der Praxis bedeutet. Kurz gesagt: ki praxis ist vor allem dann relevant, wenn du schnell verstehen willst, was konkret dahinter steckt, welche Grenzen es gibt und welche Entscheidung daraus folgt. Die Details, Quellen und Einschränkungen stehen in den folgenden Abschnitten.

Warum die HomeKit Bridge?

Home Assistant kann inzwischen mit fast jeder Funktechnik umgehen: Zigbee, Z-Wave, Matter, Bluetooth, proprietäre APIs. Apple Home dagegen bleibt ein geschlossenes System, das ohne HomeKit-Zertifizierung kaum etwas durchlässt. Die HomeKit Bridge ist die offizielle Schnittstelle, die beide Welten verbindet: Sie macht Home-Assistant-Entitäten in der Apple Home App sichtbar und per Siri steuerbar — auch Geräte, die nativ nichts mit HomeKit am Hut haben.

Die Integration ist im Home-Assistant-Kern enthalten (Home Assistant Core, Komponente homekit) und kommuniziert ausschließlich lokal. Eine Cloud ist nicht im Spiel, kein Herstellerkonto, kein Abo. Wer ein Apple-Gerät im Haus hat und Home Assistant betreibt, bekommt mit der Bridge eine der geradlinigsten Möglichkeiten, beide Plattformen zu koppeln.

Dieser Artikel beschreibt den tatsächlichen Einrichtungsweg, die Fallstricke, die in den offiziellen Docs nur als Randnotiz auftauchen, und die Grenzen, die das HomeKit Accessory Protocol dem Ganzen setzt.

Was die Bridge tut — und was nicht

Die HomeKit Bridge arbeitet in eine Richtung: Sie exportiert Home-Assistant-Entitäten nach Apple Home, nicht umgekehrt. Wer umgekehrt HomeKit-Geräte in Home Assistant einbinden will, braucht die separate HomeKit Device Integration. Die beiden Integrationen teilen sich zwar das Wort „HomeKit", haben aber entgegengesetzte Datenflüsse.

Die Bridge verhält sich aus Apples Sicht wie ein physisches HomeKit-Zubehör. Sie taucht in der Home App als koppelbare Bridge auf und meldet alle exportierten Entitäten als deren „Accessories". Technisch spricht sie HAP (HomeKit Accessory Protocol) über das lokale Netzwerk, entdeckbar via mDNS/Bonjour.

Praktisch bedeutet das: Jede in Home Assistant vorhandene Entität — Lampen, Schalter, Thermostate, Sensoren, Rollläden, Szenen, sogar Automatisierungen als Schalter verpackt — kann auf Wunsch im Apple-Ökosystem erscheinen. Die Auswahl steuert der Nutzer. Standardmäßig exportiert die Bridge alle nicht versteckten Entitäten (ausgenommen kategorisierte Konfigurations-, Diagnose- und System-Entitäten). Das klingt bequem, ist aber selten die richtige Wahl (dazu später mehr).

ki praxis – Illustration 2

Einrichtung über die UI

Der einfachste Weg ist die grafische Oberfläche von Home Assistant:

In Home Assistant zu Einstellungen → Geräte & Dienste navigieren.
Rechts unten auf Integration hinzufügen klicken.
„HomeKit Bridge" aus der Liste wählen.
Im Dialog die gewünschten Domains auswählen (etwa light, switch, sensor, cover).
Die Einrichtung abschließen.

Home Assistant generiert danach einen QR-Code und einen achtstelligen Zahlencode. Beide lassen sich in der Apple Home App scannen oder eintippen. Die Bridge erscheint als neues Gerät, und alle freigegebenen Entitäten tauchen in der Home App auf — gruppiert nach Räumen, falls die Home-Assistant-Entitäten entsprechend zugeordnet sind.

Die UI-Einrichtung ist ausreichend, wenn nur grob nach Domain gefiltert werden soll und keine entity-spezifische Konfiguration nötig ist. Sie hat aber zwei Einschränkungen: Beim Anlegen lassen sich nur Domains wählen, glob-Patterns wie binary_sensor.*_motion gibt es nur in der YAML-Konfiguration. Einzelne Entitäten lassen sich später über die Optionen der Bridge ein- oder ausschließen. Und entity_config-Werte wie code, type oder linked_battery_sensor lassen sich nicht in der UI setzen — dafür ist YAML nötig.

Die YAML-Konfiguration

Wer feinere Kontrolle braucht, richtet die Bridge in configuration.yaml ein. Das offizielle Beispiel zeigt die verfügbaren Optionen:

homekit:
  - name: "HASS Bridge"
    port: 21063
    filter:
      include_domains:
        - light
        - switch
        - cover
      include_entity_globs:
        - binary_sensor.*_occupancy
      include_entities:
        - sensor.wohnzimmer_temperatur
      exclude_entities:
        - light.flur_unten
    entity_config:
      alarm_control_panel.alarmanlage:
        code: 1234
      light.kuechentisch:
        name: Küchentisch
      switch.schlafzimmer_steckdose:
        type: outlet
      camera.terrasse:
        support_audio: true

Wichtig: Wer eine Bridge bereits über die UI erstellt hat, darf sie nicht zusätzlich per YAML konfigurieren. Das erzeugt eine zweite Instanz auf einem anderen Port, statt die bestehende zu erweitern. Die offizielle Dokumentation empfiehlt es entsprechend: UI-Instanzen bleiben UI, YAML-Instanzen bleiben YAML. Mischen führt zu doppelten Bridges und Verwirrung.

Ein Reset einer YAML-Bridge funktioniert so: Integration in der UI löschen, Home Assistant neu starten. Die YAML-Konfiguration wird automatisch neu eingelesen, die Bridge taucht frisch auf und kann neu gekoppelt werden.

Die 150er-Grenze

Das HomeKit Accessory Protocol (HAP) begrenzt eine einzelne Bridge auf 150 eindeutige Accessories (Quelle: Home Assistant HomeKit Bridge Docs). Das ist keine Empfehlung, sondern ein Protokoll-Limit — wer mehr als 150 Entitäten exportiert, riskiert undefiniertes Verhalten.

Die Zahl ist bei größeren Home-Assistant-Installationen schnell erreicht. Ein durchschnittliches Smarthome mit mehreren Räumen, ein paar Zigbee-Sensoren, etwas Beleuchtung und einigen Schaltern kommt je nach Ausstattung leicht auf 80 bis 120 Entitäten. Die in der Community diskutierte Lösung: mehrere Bridges.

Ob man Bridges nach Gerätetyp trennt (eine für Licht, eine für Sensoren, eine für Rolläden) oder nach anderer Logik, ist Geschmackssache. In der Home Assistant Community werden beide Ansätze praktiziert. Ein Nutzer fragt dort mit rund 120 Geräten nach Best Practices; ein anderer berichtet, dass er separate Bridges pro Gerätetyp fährt, weil ihm das die Verwaltung vereinfacht — eine organisatorische Entscheidung, keine technische Notwendigkeit.

Ein anderer Diskussionsteilnehmer bringt einen interessanten Punkt ein: HomeKit sendet pro Bridge immer nur eine Anfrage und wartet auf die Antwort, bevor die nächste gesendet wird. Wer also 15 Rollläden gleichzeitig schließen will, profitiert davon, jedem Rolladen eine eigene Bridge zu geben, weil die Befehle dann parallel ankommen. Das ist ein Performance-Argument, das in den offiziellen Docs nicht steht und auch nicht systematisch getestet wurde, aber auf beobachtetem Verhalten basiert. Wie viele separate Bridges ein Netzwerk und ein Apple Home Hub verkraften, ist nicht offiziell dokumentiert — ein Teilnehmer schätzt rund 30 Bridges als unproblematisch und fährt selbst eine ähnliche Zahl an Einzel-Bridges ohne spürbare Probleme.

Accessory Mode: Kameras, Schlösser, TVs

Nicht jede Entität verträgt sich mit dem Bridge-Modus. Für Kameras, Schlösser und TV-Mediaplayer (Geräteklasse tv oder receiver) sowie für aktivitätsbasierte Fernbedienungen schreibt das Protokoll den Accessory Mode vor. In diesem Modus verhält sich die Entität nicht als Teil einer Bridge, sondern als eigenständiges Zubehör.

Die Einrichtung in der UI läuft so: Eine neue Bridge anlegen, media_player, remote, lock und camera als Domains auswählen. Home Assistant erkennt die betreffenden Entitäten und erzeugt automatisch separate Accessory-Einträge. Die ursprüngliche Bridge kann danach entfernt werden, falls sie nur für diesen Zweck angelegt wurde.

Für eine einzelne Kamera oder ein einzelnes Schloss geht der Weg über die Bridge-Optionen: Modus auf accessory setzen und die gewünschte Entität auswählen. Das Paaren erfolgt dann pro Accessory einzeln.

Kameras im Accessory Mode unterstützen H.264-Streaming. Die Konfiguration erlaubt, Auflösung, FPS, Codec und Audio zu steuern. Besonders relevant für Raspberry-Pi-Nutzer: Mit video_codec: h264_v4l2m2m lässt sich die Hardware-Encoding-Einheit des Pi nutzen, was die CPU-Last beim Streamen drastisch senkt.

Filter: Weniger ist fast immer mehr

Die Default-Einstellung der Bridge — alle nicht versteckten Entitäten exportieren — führt in der Praxis zu überfüllten Home-Apps und unnötigem Netzwerkverkehr. Ein Filter sollte in fast jeder Installation gesetzt werden, mindestens auf Domain-Ebene.

Die YAML-Filteroptionen im Überblick:

include_domains / exclude_domains: ganze Geräteklassen ein- oder ausschließen
include_entity_globs / exclude_entity_globs: Wildcard-Muster, etwa binary_sensor.*_motion
include_entities / exclude_entities: einzelne Entitäten namentlich

Die Empfehlung aus der Praxis: zunächst include_domains auf die wirklich benötigten Typen beschränken (Licht, Schalter, Abdeckungen, Klima), dann mit exclude_entities einzelne Störer entfernen. Glob-Patterns sind nützlich, um eine ganze Kategorie von Binärsensoren zu exportieren, ohne jeden einzeln aufzählen zu müssen.

Automationen und Szenen nach HomeKit exportieren

Home Assistant kann Automationen und Szenen als Schalter in HomeKit exportieren. Das ist nützlich, um HA-Automationen per Siri auszulösen oder in Apple-Home-Automationen einzubinden — etwa „Gute Nacht" als Szene in HomeKit starten, die dann eine HA-Automation triggert.

Die Umsetzung ist simpel: Die Integration unterstützt Automationen (Domain automation) direkt — wer die Domain im Bridge-Filter einbezieht, bekommt jede Automation als schaltbare Entität. In Apple Home erscheint sie als Schalter — Einschalten führt die Automation aus, Ausschalten ist ohne Effekt, sofern nicht explizit eine Ausschalt-Automation hinterlegt ist.

Szenen sind ebenfalls direkt unterstützt: Sie tauchen als Schalter in der Bridge auf und lassen sich über den Filter (Domain scene) freigeben. Ein Umweg über Template-Skripte ist dafür nicht nötig. Wer viele Szenen exportieren will, sollte sie im Filter gezielt auswählen, damit die Home App übersichtlich bleibt.

Docker, mDNS und Firewall

Wer Home Assistant im Docker-Container ohne Host-Netzwerkmodus betreibt, muss sich um mDNS kümmern. Die Bridge setzt auf Multicast DNS zur Ankündigung — ohne das finden Apple-Geräte die Bridge nicht.

Die Lösung ist ein mDNS-Forwarder wie avahi-daemon im Reflector-Modus auf dem Docker-Host. Zusätzlich muss in der Bridge-Konfiguration advertise_ip auf die statische IP des Hosts gesetzt werden:

homekit:
  advertise_ip: "192.168.1.100"

Ohne diese Konfiguration bleibt die Bridge für Apple-Geräte unsichtbar oder verschwindet nach kurzer Zeit wieder.

Firewall-Regeln sind ein weiterer häufiger Stolperstein. Die Bridge benötigt im lokalen Netzwerk freien Verkehr auf dem konfigurierten Port (Standard: 21063). Wer VLANs oder streng getrennte Netze betreibt, muss dafür sorgen, dass iOS-Geräte und Home Hubs die Bridge-IP erreichen können — und umgekehrt.

Home Hubs: Der unterschätzte Flaschenhals

Apple Home braucht einen Home Hub (HomePod, HomePod mini oder Apple TV), um Automatisierungen auszuführen und Fernzugriff zu ermöglichen. iPads werden von Apple seit dem 10. Februar 2026 nicht mehr als Home Hub unterstützt (Ende der Legacy-Home-Architektur). Weniger bekannt: Der Hub muss auch alle gebridgeten Accessories verwalten. Je mehr Entitäten exportiert werden, desto mehr Last liegt auf dem Hub.

Die offizielle Home-Assistant-Dokumentation dokumentiert Tests mit 400 Accessories (durchgeführt mit Home Assistant 2021.6 und iOS/tvOS 14.6). Ergebnisse:

HomePod, HomePod Mini, Apple TV 4K Gen 2: stabil mit 400 Accessories (Apple TV 4K Gen 2 am besten mit Ethernet)
Apple TV 4K Gen 1: stabil mit 300 Accessories (Ethernet empfohlen)
Apple TV HD und iPad-Modelle: Probleme mit vielen Accessories berichtet

Die Zahlen sind mit Vorsicht zu lesen — sie stammen aus Tests mit einer inzwischen rund fünf Jahre alten HA-Version (2021.6). Dennoch bleibt die Grundregel: Ein leistungsfähiger, per Ethernet angebundener Home Hub ist die beste Basis für große Bridge-Installationen. Wer noch ein iPad als Hub nutzt, muss ohnehin auf Apple TV oder HomePod wechseln, weil Apple iPads seit Februar 2026 nicht mehr als Home Hub unterstützt — bei vielen Accessories ist ein per Ethernet angebundener Apple TV die robusteste Wahl.

Pairing-Probleme und Reset

Die Kopplung zwischen HomeKit Bridge und Apple Home läuft in der Regel reibungslos, aber wenn sie fehlschlägt, sind die Fehlermeldungen kryptisch. Häufige Ursachen:

Falsches Netzwerk: Das iPhone, mit dem gekoppelt wird, muss im selben Subnetz sein wie die Bridge. VLANs oder Gastnetze blockieren die mDNS-Erkennung.

Firewall auf dem HA-Host: UFW, iptables oder eine vorgelagerte Hardware-Firewall können mDNS (Port 5353/UDP) und den Bridge-Port blockieren. Schnelltest: avahi-browse -a auf dem HA-Host ausführen, um zu prüfen, ob die Bridge im mDNS sichtbar ist.

Cache-Probleme auf iOS: Manchmal hilft ein Neustart des iPhones oder das kurzzeitige Deaktivieren und Wiederaktivieren von WLAN. HomeKit cached alte Pairing-Informationen aggressiv.

Ein Reset der Bridge löscht alle Kopplungen und setzt sie in den Werkszustand zurück. Bei UI-erstellten Bridges geschieht das über die Integrationsseite: Bridge auswählen, auf die drei Punkte klicken, „Zurücksetzen" wählen. Bei YAML-Bridges: Integration in der UI löschen und Home Assistant neu starten. Nach dem Reset muss die Bridge neu gekoppelt werden, alle vorherigen Home-App-Konfigurationen sind verloren.

Troubleshooting: Wenn Geräte nicht reagieren

Das häufigste Problem nach der Einrichtung: Einige oder alle Geräte sind in der Home App zeitweise nicht erreichbar („Keine Antwort"). Die Ursachen sind vielfältig, aber es gibt ein paar systematische Prüfpunkte.

entity_id-Änderungen: Die Bridge nutzt die entity_id, um eine Accessory-ID zu generieren. Wird eine entity_id geändert, die keine unique_id hat, gehen alle Home-App-Konfigurationen für dieses Gerät verloren — Raumzuordnung, Szenen, Automationen. Das ist kein Bug, sondern eine Folge des HAP-Designs. Vorsicht also bei Aufräumaktionen in Home Assistant.

mDNS-Probleme: Unter Linux, insbesondere in Docker-Umgebungen, kann mDNS unzuverlässig sein. Symptom: Bridge wird beim Koppeln gefunden, verschwindet aber später. Prüfen, ob avahi-daemon läuft und ob die Firewall mDNS-Pakete (Port 5353/UDP) durchlässt.

Mehrere Home Hubs: Ältere Hubs im Netzwerk (Apple TV HD; iPads sind seit Februar 2026 ohnehin nicht mehr als Home Hub nutzbar) sollten deaktiviert werden, wenn sie nicht als primärer Hub benötigt werden. Sie können die Kommunikation mit vielen Accessories verlangsamen oder blockieren.

UI vs. YAML: Wer versehentlich eine UI-Bridge per YAML zu konfigurieren versucht, erzeugt eine zweite Instanz. Die alte Bridge läuft weiter, die neue konkurriert. Lösung: Alle Bridges in der UI prüfen, doppelte Einträge löschen und konsistent einen Weg wählen.

entity_config: Feineinstellungen für einzelne Geräte

Für Entitäten, die in HomeKit anders aussehen oder sich anders verhalten sollen als in Home Assistant, gibt es entity_config. Die nützlichsten Optionen:

name: überschreibt den Anzeigenamen in HomeKit. Wichtig: HomeKit cached den ersten Namen. Eine spätere Änderung wird erst nach einem Reset der Bridge übernommen.
type: setzt den Accessory-Typ für switch- und fan-Entitäten. Ein Switch kann als outlet, faucet, shower, sprinkler, switch oder valve erscheinen — relevant für Siri-Sprachbefehle („Schalte die Steckdose aus" vs. „Schalte den Schalter aus").
linked_battery_sensor: verknüpft einen Batteriesensor mit einem Gerät, sodass HomeKit den Ladestand anzeigt und bei niedrigem Stand warnt.
linked_motion_sensor und linked_doorbell_sensor: für Kameras — ermöglichen Bewegungsbenachrichtigungen und Türklingelfunktion.
code: für Alarmanlagen und Schlösser — der Code, mit dem HomeKit scharf/unscharf schaltet bzw. entriegelt.

Diese Optionen existieren nur in der YAML-Konfiguration, nicht in der UI.

Grenzen und Abwägungen

Die HomeKit Bridge ist stabil, gut dokumentiert und seit Jahren im Home-Assistant-Kern. Aber sie hat Grenzen, die man vor der Einrichtung kennen sollte.

Keine native Zwei-Wege-Synchronisation: Wird ein Gerät in HomeKit umbenannt oder in einen anderen Raum verschoben, spiegelt sich das nicht nach Home Assistant zurück. Beide Systeme führen getrennte Bücher.

Abhängigkeit von Apple-Hardware: Ohne Apple TV oder HomePod im Netzwerk funktioniert HomeKit nur lokal auf dem iPhone — kein Fernzugriff, keine Automationen. Das ist eine Apple-Entscheidung, keine HA-Schwäche, aber für reine Android-Haushalte mit einem Test-iPhone ein relevanter Punkt.

HAP-Latenz: Die Bridge übersetzt jedes HomeKit-Kommando in einen HA-Dienstaufruf. Das funktioniert in der Praxis meist spürbar schnell — ein offizieller Richtwert existiert nicht, in der Regel liegt die Latenz weit unter einer Sekunde. Bei vielen parallelen Kommandos (etwa „Alle Lichter aus") kann die serielle Verarbeitung pro Bridge zu spürbaren Verzögerungen führen — ein Grund, bei großen Installationen über mehrere Bridges nachzudenken.

Entitäten mit Sonderfunktionen: Nicht jede HA-Entität lässt sich sinnvoll nach HomeKit übersetzen. RGBW-Lampen mit Farbtemperatursteuerung funktionieren gut. Ventilatoren unterstützen laut Doku Stufen- und Oszillationssteuerung, wie viele Optionen die Home-App konkret anzeigt, hängt aber von iOS-Version und Gerätetyp ab. Vor dem Export lohnt sich ein Blick in die Liste der unterstützten Integrationen in den offiziellen Docs.

Entscheidungshilfe: Wann ist das sinnvoll?

Eher sinnvoll, wenn du ki praxis nicht nur als Nachricht lesen willst, sondern eine praktische Einordnung brauchst: Was ändert sich, wen betrifft es und welche nächsten Schritte sind realistisch?

Eher abwarten, wenn die Quellenlage noch dünn ist, wichtige technische Details fehlen oder der Nutzen nur aus Hersteller- oder Projektversprechen besteht. Dann ist Beobachten besser als vorschnelles Umstellen.

Worauf du achten solltest: konkrete Verfügbarkeit, nachvollziehbare Kosten, offene Einschränkungen, Sicherheits- oder Datenschutzfolgen und belastbare Quellen statt bloßer Ankündigungen.

Fazit

Die HomeKit Bridge ist eine der ausgereiftesten Integrationen in Home Assistant. Sie tut, was sie soll, ohne Cloud, ohne Abo, ohne Herstellerbindung. Die Einrichtung ist in fünf Minuten erledigt, wenn man die UI nutzt und die Standardeinstellungen passen. Wer mehr als 30 bis 50 Entitäten exportiert oder Docker ohne Host-Netzwerk betreibt, investiert besser eine Stunde in durchdachte Filter, YAML-Konfiguration und mDNS-Debugging.

Die 150er-Grenze pro Bridge ist das einzige harte technische Limit. Die Entscheidung zwischen einer oder mehreren Bridges hängt von der Installationsgröße ab und davon, wie wichtig parallele Kommandos im Alltag sind. Die Community-Erfahrung legt nahe, dass man mit drei bis fünf Bridges pro Gerätekategorie einen guten Kompromiss aus Organisation und Performance bekommt — wer das Maximum an Parallelverarbeitung will, geht auf Einzel-Bridges pro Gerät.

Am wichtigsten: Vor dem Export filtern. Eine überfüllte Home App ist schlimmer als gar keine.

Passende Produktrecherchen

Wenn du die praktische Seite vertiefen möchtest, findest du hier passende Suchpfade zum Vergleichen. Keine Kaufpflicht, keine Rangliste, sondern thematisch passende Produktrecherchen:

Hinweis: Als Amazon-Partner verdient kalika.de an qualifizierten Verkäufen. Für dich ändert sich der Preis nicht.

Quellen

ki praxis – Illustration 3

Weiterführende Artikel

Transparenzhinweis

Dieser Beitrag wurde mit Unterstützung künstlicher Intelligenz erstellt und automatisiert auf Quellen, Fakten und Qualitätskriterien geprüft.