Im Frühjahr 2026 beschreibt GitHub-Nutzer mhaegglund in Issue #160717 ein Problem, das tatsächlich frustrierend ist: Nach dem Update auf Home Assistant 2026.1 mit inzwischen 3.856 Entitäten lässt sich die HomeKit-Bridge-Konfiguration in der Benutzeroberfläche nicht mehr bedienen. Das Interface friert beim Laden der Geräteliste ein. Der Nutzer kann weder Geräte hinzufügen noch entfernen. Das Issue wurde als "not planned" geschlossen.

Das Ticket ist geschlossen, das Problem bleibt: Je größer die HA-Installation, desto ungemütlicher wird die HomeKit-Bridge-Verwaltung. Die Grenzen kommen von Apple, nicht von HA, und sie sind seit Jahren unverändert.

Dieser Artikel beschreibt, wie die beiden Integrationswege funktionieren, was das 150-Geräte-Limit in der Praxis bedeutet, welche Bugs in 2025 und 2026 aufgetaucht sind, und warum man trotz HA-Bridge einen HomePod oder Apple TV braucht.

Zwei Wege, nicht einer

Es gibt zwei völlig verschiedene Integrationen, die beide mit "HomeKit" im Namen auftauchen, und die Verwechslung ist häufig.

HomeKit Bridge (Integration-ID: homekit) macht Home-Assistant-Geräte in Apple Home sichtbar. Wenn man einen Zigbee-Temperatursensor in HA hat, der kein HomeKit-Logo trägt, kann man ihn über die Bridge trotzdem in der Apple-Home-App steuern und in Siri-Automationen nutzen. Die Bridge läuft auf dem HA-Host und zeigt sich gegenüber iOS als ein HomeKit-Zubehör. HomeKit Controller (Integration-ID: homekit_controller) macht es umgekehrt: Geräte mit echtem "Works with Apple HomeKit"-Zertifikat werden direkt in Home Assistant eingebunden, ohne Umweg über die Apple-Home-App. Das ist der richtige Weg für Aquara-Sensoren, Eve-Schalter oder andere Geräte, die nativ HomeKit sprechen.

Beide können gleichzeitig aktiv sein. Ein Eve-Energy-Plug lässt sich über HomeKit Controller in HA einbinden und dann über HomeKit Bridge zurück an Apple Home exponieren. Das macht man, wenn man in HA Automationen auf dieses Gerät bauen will, die HomeKit allein nicht hinbekommt, zum Beispiel Reaktion auf Energieverbrauchsschwellen oder Verknüpfung mit Nicht-HomeKit-Geräten.

HomeKit Bridge einrichten

Der Weg über die UI: Einstellungen, Geräte und Dienste, Integration hinzufügen, "Apple" oder "HomeKit" suchen, HomeKit Bridge auswählen. HA fragt, welche Gerätetypen exponiert werden sollen. Standardmäßig sind Lichter, Schalter, Sensoren und Klimageräte vorausgewählt.

Nach dem Speichern erscheint in den Benachrichtigungen ein QR-Code mit einem 8-stelligen PIN. Den iPhone-Kameraapp draufhalten, Apple Home öffnet sich und fragt, ob die Bridge hinzugefügt werden soll. Danach erscheinen alle exponierten Geräte als Accessories in Apple Home.

Wichtig: Der PIN hat das Format XXX-XX-XXX. Er taucht nur beim ersten Einrichten auf. Wer ihn verpasst, findet ihn im Log unter Einstellungen > System > Logs mit dem Suchbegriff "homekit".

Der Port ist standardmäßig 21063 (TCP). Für mDNS wird UDP 5353 genutzt. Wer HA in Docker betreibt, muss entweder network_mode: host setzen oder einen avahi-Daemon als mDNS-Reflektor konfigurieren, weil multicast DNS-Pakete Docker-Netzwerkgrenzen nicht überqueren. Die kritische Einstellung im avahi.conf: disallow-other-stacks=no, sonst blockiert Avahi die HA-eigene mDNS-Annonce.

Das 150-Geräte-Limit

Das HomeKit Accessory Protocol erlaubt maximal 150 Accessories pro Bridge. Das ist keine HA-Einschränkung, sondern eine Protokollvorgabe von Apple.

Bei kleinen Installationen: kein Problem. Wer 30 Lichter, 10 Schalter und 20 Sensoren hat, ist weit entfernt. Wer aber Dutzende ESP32-Sensoren, Zigbee-Geräte, Wetter-Entitäten und Hilfsvariablen exponiert, erreicht 150 schneller als erwartet. Und wer wie mhaegglund fast 4.000 Entitäten hat, merkt, dass schon das Konfigurieren der Bridge zur Geduldsprobe wird.

Die Lösung aus der Dokumentation: mehrere Bridge-Instanzen anlegen. Eine zweite Bridge braucht einen anderen Port (z.B. 21064) und einen eigenen Namen. Über die filter-Option in YAML lässt sich festlegen, welche Domains oder Entitäten auf welcher Bridge landen:

homekit:
  - name: HA Bridge 1
    port: 21063
    filter:
      include_domains:
        - light
        - switch
  - name: HA Bridge 2
    port: 21064
    filter:
      include_domains:
        - sensor
        - binary_sensor
        - climate

Die UI-Konfiguration unterstützt mehrere Bridges, wird aber ab etwa 500 Entitäten träge, wie Issue #160717 zeigt. Für große Installationen ist YAML-Konfiguration stabiler.

Ein Hinweis zum Umbenennen von Entitäten: Die Bridge speichert Accessories anhand der entity_id. Wer sensor.wohnzimmer_temperatur in sensor.wohnzimmer_temp umbenennt, verliert die HomeKit-Konfiguration dieses Geräts in Apple Home. Es erscheint als neues Accessory, und alle Siri-Automationen, die darauf zeigen, müssen neu gemacht werden.

HomeKit Controller: Geräte direkt in HA einbinden

Geräte mit HomeKit-Zertifikat tauchen nach der Installation von homekit_controller in HA automatisch in den erkannten Integrationen auf, sofern sie im selben Netzwerk sind und noch mit keinem anderen Controller gekoppelt sind.

Das letzte "und" ist wichtig. HomeKit-Geräte können immer nur mit einem Controller gleichzeitig gekoppelt sein. Wer sein Eve Energy bisher in Apple Home hatte und es jetzt nach HA umziehen will, muss es zuerst aus der Home-App entfernen. Danach ist es automatisch für HA zur Kopplung verfügbar.

Der Pairing-Code steht auf dem Gerät oder auf der Verpackung. Format: XXX-XX-XXX. Wer ihn verloren hat, hat Pech: Es gibt keinen Weg, ihn zurückzusetzen oder auszulesen. Herstellerkontakt oder Gerät ersetzen sind die einzigen Optionen.

Für Thread-fähige Geräte (z.B. neuere Eve-Modelle oder Aqara M3-Accessories) gibt es einen Sonderweg: Das Gerät über die iPhone-Kamera mit Apple Home koppeln, damit die Thread-Netzwerkkredentials auf das Gerät übertragen werden, dann aus Apple Home entfernen, ohne das Gerät zurückzusetzen. HA kann es danach über Thread einbinden, weil die Netzwerkdaten noch auf dem Gerät sind.

Geräte, die über HomeKit Controller eingebunden sind, liefern folgende Entitäten je nach Gerätetyp: Sensoren (Temperatur, Luftfeuchtigkeit, CO2, Lichtstärke), Binärsensoren (Bewegung, Tür/Fenster), Schalter, Lichter, Schlösser, Thermostate. Schaltflächen und Türklingeln ohne Zustand sind nur als Device Automations verfügbar, nicht als reguläre Entitäten.

Was Apple Home als Hub braucht

Eine häufige Fehlvorstellung: HA als HomeKit Bridge ersetzt den Apple-Home-Hub.

Tut es nicht. Für Fernzugriff auf Apple-Home-Geräte, für zeitgesteuerte HomeKit-Automationen und für HomeKit Secure Video ist nach wie vor ein Apple-Home-Hub notwendig: HomePod mini, HomePod oder Apple TV 4K (2. Generation oder neuer). Ein iPad funktioniert formal als Hub, wird aber seit iOS 16 von Apple nicht mehr aktiv unterstützt und ist für neue Installationen nicht empfehlenswert.

Was HA als Bridge tut: Es stellt eigene Geräte in HomeKit bereit. Was Apple Home daraus macht, liegt an Apple Home. Wenn der iPhone-Nutzer von unterwegs auf das über Bridge exponierte Licht zugreifen will, braucht Apple Home dafür einen Hub im Heimnetz.

Die Faustregel: Wer Apple Home als UI für HA-Geräte nutzen will, aber keine HomeKit-Automationen plant und immer im Heimnetz ist, kommt ohne Hub aus. Für alles andere ist ein HomePod mini (ab ca. 99 Euro) der einfachste Weg.

Siri und HA: was wirklich funktioniert

Über HomeKit Bridge exponierte Geräte können per Siri gesteuert werden, wie jedes andere HomeKit-Accessory. "Hey Siri, Wohnzimmerlicht aus" funktioniert, wenn das Licht in HA eingebunden und über Bridge in Apple Home sichtbar ist.

Für komplexere HA-Aktionen, also Automationen auslösen, Scripts starten oder Vorlagen ausführen, gibt es einen zweiten Weg: die Siri-Shortcuts-Integration der HA-Companion-App.

Über Shortcuts können HA-Aktionen als eigene Siri-Befehle hinterlegt werden. Die Companion-App bietet seit iOS 18 direkte Entitäten für Lichter, Schalter und Lüfter als native App Intents. Komplexere Aktionen, etwa eine Automation starten, sind ab iOS 17 verfügbar. Der Unterschied zur Bridge: Shortcuts-Befehle gehen über die HA-Companion-App, also über die Instanz-URL. Das erfordert Internetzugang oder Nabu-Casa-Abo für Fernzugriff. HomeKit-Bridge-Geräte funktionieren hingegen lokal, ohne HA-Companion.

Probleme in 2025 und 2026

Zwei Probleme der letzten Monate sind erwähnenswert, weil sie spezifisch und nicht offensichtlich sind.

iOS-Control-Center-Widgets bleiben leer (Issue #155494, Oktober 2025): Nach iOS 18.1 hat Apple neue HomeKit-Widgets im iOS Control Center eingeführt. Geräte, die über HA HomeKit Bridge exponiert sind, erscheinen in diesen Widgets nicht, obwohl sie in der Apple-Home-App korrekt funktionieren. Native HomeKit-Accessories zeigen sich problemlos. Das Issue ist dem Maintainer bdraco zugewiesen und steht noch ohne Fix. Apple hat das Verhalten in iOS 26.4.2 bestätigt als bekannten Bug (Feedback-ID FB22601988), mit der Aussage, die Controls "heilen sich mit etwas Zeit" von selbst nach Neustarts. HA 2025.2 HomeKit Bridge offline (Issue #137509, Februar 2025): Nach dem Update auf 2025.2.0 meldeten einige Nutzer, dass alle Bridge-Geräte in Apple Home als offline erschienen. HA zeigte noch die alte Bridge-Version an. Ein Neustart der Bridge-Instanz half nicht in allen Fällen. Das Issue wurde als "needs-more-information" markiert und Maintainer bdraco zugewiesen. Wer dieses Verhalten nach einem HA-Update sieht, sollte die Bridge-Integration unter Einstellungen, Geräte und Dienste vollständig entfernen, HA neu starten und die Bridge neu einrichten. Die .storage/homekit-Datei aus dem Konfigurationsordner sollte dabei gesichert werden, weil sie die Pairing-Informationen enthält. Ohne diese Datei muss der QR-Code neu gescannt werden.

Warum überhaupt beides?

Für viele Haushalte reicht eins von beidem. Wer beides betreibt, hat meistens einen konkreten Grund dafür, keinen abstrakten.

Erstens: Apple Home für Familienmitglieder, HA für eigene Automationen. Die Apple-Home-App ist intuitiv, Siri-Befehle funktionieren zuverlässig, und der Rest der Familie muss kein YAML lernen. HA läuft im Hintergrund und macht die komplexe Steuerung. Die Bridge verbindet beide.

Zweitens: Geräte, die keinen HomeKit-Support haben, sollen trotzdem per Siri steuerbar sein. Zigbee-Geräte, ESP-basierte Sensoren, lokale Tuya-Geräte: Alles, was HA einbinden kann, lässt sich über Bridge in HomeKit bringen.

Drittens: Matter. Matter-Geräte können mit mehreren Controllern gleichzeitig gekoppelt sein (Multi-Admin). Wer ein Matter-Gerät sowohl in HA als auch in Apple Home haben will, braucht keine Bridge, sondern kann es direkt in beiden Systemen koppeln. Das ist sauberer als der Bridge-Weg, funktioniert aber nur mit Matter-Geräten.

Kurz: Bridge für alles vor Matter (Zigbee, Z-Wave, lokale APIs, ESPHome). Matter-Geräte direkt in beiden Systemen koppeln, wo es geht. Das ist sauberer und funktioniert ohne die Abhängigkeit zu HA als Vermittler.

Was nicht geht

HomeKit Secure Video über HA Bridge wird nicht unterstützt. Kameras lassen sich zwar exponieren, aber die verschlüsselte Cloud-Aufzeichnung von Apple läuft nur mit nativen HomeKit-Kameras.

TV-Geräte (Media Player mit device_class: tv oder receiver) können nicht über eine normale Bridge exponiert werden. Sie brauchen den Accessory-Modus, also eine eigene Bridge-Instanz nur für dieses Gerät. In der Praxis bedeutet das: Wer einen Fernseher per Siri steuern will, muss eine zweite Bridge speziell dafür einrichten.

Das Umbenennen von Entitäten in HA zerstört die HomeKit-Konfiguration, wie oben beschrieben. Das ist ein strukturelles Problem: HA nutzt entity_id als Identifier, HomeKit hängt seine aid (Accessory ID) daran. Keine einfache Lösung in Sicht.

Quellen: