In diesem Beitrag zeige ich dir, wie du deine Home Assistant Entitäten mit der HomeKit Integration über die Home App auf iPhone, iPad und Mac steuern kannst. Die Integration heißt in Home Assistant HomeKit Bridge, und damit landen auch Geräte in Apple Home, die selbst gar kein HomeKit können.
Du bekommst hier beide Wege: die Einrichtung über die Oberfläche Schritt für Schritt und die YAML-Variante für Fortgeschrittene, mit Domains, Filtern, Wildcard-Filtern und Ausnahmen einzelner Geräte. Im Video siehst du das Ganze nochmal in Aktion.
Voraussetzungen
- Ein laufendes Home Assistant. Wenn du noch ganz am Anfang stehst, hilft dir mein Home Assistant Starter Guide, und passende Hardware findest du in meinen Hardware-Empfehlungen.
- Ein iPhone oder iPad mit der Home App, das sich beim Koppeln im selben lokalen Netzwerk wie Home Assistant befindet.
- Für Steuerung von unterwegs und für Automationen in Apple Home brauchst du wie bei jedem HomeKit-Gerät eine Steuerzentrale (Apple TV oder HomePod).
Benutze Repos / Links
HomeKit Bridge über die Oberfläche einrichten
Für die meisten reicht die Einrichtung über die Oberfläche völlig aus. So gehst du vor:
- Geh auf
Einstellungen → Geräte & Diensteund klick auf Integration hinzufügen. Such nach HomeKit Bridge. Achtung, nicht mit HomeKit Device verwechseln: Das ist der umgekehrte Weg und holt HomeKit-Geräte in Home Assistant. - Im ersten Schritt wählst du die Domains aus, die in Apple Home landen sollen, z. B. Licht, Abdeckung, Klima oder Schalter. Alle unterstützten Entitäten dieser Domains werden übernommen, außer Konfigurations- und Diagnose-Entitäten.
- Hast du Kameras, Schlösser, Fernseher bzw. Receiver (Mediaplayer) oder aktivitätsbasierte Fernbedienungen ausgewählt, legt Home Assistant für jedes dieser Geräte automatisch eine eigene Instanz im Zubehörmodus an. Dazu unten mehr.
- Nach dem Abschließen legt Home Assistant die Bridge an. Sie heißt dann z. B.
HASS Bridge:21064, die Zahl ist der Port.
Mit der Home App koppeln (QR-Code oder Code)
- In Home Assistant erscheint unter den Benachrichtigungen (Glocke in der Seitenleiste) ein Eintrag „HomeKit Pairing“ mit QR-Code und Kopplungscode.
- Öffne auf dem iPhone die Home App, tipp auf + und dann auf Gerät hinzufügen.
- Scanne den QR-Code direkt vom Bildschirm. Klappt das nicht, wähl die Option ohne Code und such dir die Bridge aus der Liste, dann tippst du den Kopplungscode ein.
- Die Home App warnt, dass es sich um ein nicht zertifiziertes Gerät handelt. Das ist normal, einfach trotzdem hinzufügen.
- Danach weist du der Bridge und den Geräten Räume zu. Fertig, deine Home Assistant Geräte sind jetzt in Apple Home und per Siri steuerbar.
Jede Instanz im Zubehörmodus (also z. B. jedes Schloss oder jede Kamera) koppelst du einzeln auf dieselbe Weise, jede bekommt ihre eigene Benachrichtigung mit Code.
Entitäten nachträglich anpassen
Was genau in Apple Home landet, legst du über Einstellungen → Geräte & Dienste → HomeKit Bridge und dann Konfigurieren fest. Dort kannst du heute über die Oberfläche:
- zwischen Bridge und Zubehör als Modus wählen,
- die Domains ändern und per Einschließen nur bestimmte Entitäten freigeben oder per Ausschließen einzelne Entitäten aus einer Domain rausnehmen,
- bei Kameras festlegen, welche schon H.264 liefern und welche Ton haben,
- bei Klima-Entitäten zwischen Thermostat und Heater Cooler (Klimaanlagen-Kachel) wählen,
- Geräte-Auslöser freigeben: Für ausgewählte Geräte, z. B. einen Zigbee-Taster, legt die Bridge programmierbare Schalter an, die du in Apple Home für Szenen und Automationen nutzen kannst.
Ausgeblendete Entitäten sowie Konfigurations- und Diagnose-Entitäten kommen nur nach Apple Home, wenn du sie im Einschließen-Modus ausdrücklich auswählst. Wenn ein Gerät fehlt, ist das oft der Grund.
Bridge oder Zubehörmodus?
Im Bridge-Modus (Standard) bündelt eine Instanz viele Entitäten, so wie eine Hue Bridge viele Lampen. Im Zubehörmodus stellt eine Instanz genau eine Entität als eigenständiges Gerät bereit.
Den Zubehörmodus brauchst du für Kameras, Schlösser, Mediaplayer mit der Geräteklasse TV oder Receiver und aktivitätsbasierte Fernbedienungen, sonst funktionieren sie in Apple Home nicht richtig. Am einfachsten ist der Weg aus Schritt 3 oben: Domains auswählen, und Home Assistant legt die nötigen Zubehör-Instanzen selbst an. Willst du nur eine einzelne Entität im Zubehörmodus, legst du eine neue HomeKit Bridge an, öffnest vor dem Koppeln Konfigurieren, stellst den Modus auf Zubehör und wählst die Entität aus.
Typische Stolperfallen
Die Bridge taucht in der Home App nicht auf
Fast immer ist das ein Netzwerkthema. HomeKit findet die Bridge per mDNS (Bonjour), und das muss zwischen iPhone und Home Assistant durchkommen:
- iPhone und Home Assistant im selben Netz. Getrennte VLANs oder ein Gäste-WLAN blockieren mDNS häufig.
- Läuft auf dem Home-Assistant-System eine Firewall, müssen UDP 5353 (mDNS) und der TCP-Port der Bridge offen sein (Standard 21063 bei YAML, ab 21064 bei Bridges aus der Oberfläche).
- Home Assistant in Docker:
network_mode: hostverwenden. Als VM, z. B. auf Proxmox, muss die VM direkt im Heimnetz hängen (Netzwerkbrücke), nicht hinter NAT. - Die Doku nennt außerdem die IGMP-Einstellungen des Routers: Wenn alle Geräte kurz nach dem Start auf „Keine Antwort“ springen, lohnt ein Blick dorthin. Die Standardeinstellungen funktionieren meist am besten.
Maximal 150 Geräte pro Bridge
Das HomeKit-Protokoll erlaubt höchstens 150 Zubehörteile pro Bridge. Wer einfach alle Sensoren und Schalter durchreicht, ist da schneller als gedacht. Dann hängt die Kopplung oder bricht ab. Lösung: gezielt filtern oder auf mehrere Bridges aufteilen.
Kameras
Kameras laufen im Zubehörmodus und brauchen eine funktionierende FFmpeg-Integration. Liefert die Kamera kein H.264, muss Home Assistant umwandeln, und das schafft ein Einplatinenrechner wie der Raspberry Pi laut Doku kaum. Liefert sie H.264, setz in den Kamera-Optionen den Haken für native H.264-Streams. Allgemeines zu Kameras in Home Assistant findest du in meinem Kamera-Beitrag.
HomeKit Secure Video unterstützt die HomeKit Bridge nicht. Wenn du das willst, geht das über Scrypted: HomeKit Secure Video mit Home Assistant einrichten.
Ein Gerät reagiert nicht mehr oder Änderungen kommen nicht an
Änderst du die Konfiguration einer Entität, die schon in Apple Home ist, übernimmt die Home App das oft erst, wenn das Zubehör neu angelegt wird. Dafür gibt es die Aktion homekit.reset_accessory, die du unter Einstellungen → Werkzeuge → Aktionen ausführen kannst. Hilft gar nichts mehr, entkoppelst du mit homekit.unpair und koppelst neu.
Noch ein Detail: HomeKit merkt sich Geräte über die Entitäts-ID. Benennst du die ID einer Entität ohne eindeutige ID um, sind deren Einstellungen in der Home App (Raum, Name, Szenen) weg.
Oberfläche und YAML nicht mischen
Eine Bridge, die du über die Oberfläche angelegt hast, bearbeitest du nur über die Oberfläche. Eine Bridge aus YAML nur in YAML. Versuchst du, eine Oberflächen-Bridge per YAML anzupassen, startet einfach eine zusätzliche HomeKit-Instanz auf einem anderen Port.
Für Fortgeschrittene: HomeKit Bridge per YAML (Code meiner Integration)
Die Oberfläche deckt das meiste ab. YAML brauchst du, wenn du Wildcard-Filter (include_entity_globs), feste Namen und Ports oder Einstellungen pro Entität über entity_config willst, z. B. einen anderen Gerätetyp, einen verknüpften Batteriesensor oder einen Code fürs Schloss. Der Code kommt in deine configuration.yaml, z. B. über die App File Editor oder Studio Code Server. Danach prüfst du die Konfiguration unter Einstellungen → Werkzeuge → YAML und startest Home Assistant neu.
So sieht meine Konfiguration aus: eine Bridge für Rollläden, Lichter, ausgewählte Heizungen und ein paar Einzelgeräte, und eine zweite Instanz im Zubehörmodus nur für das Türschloss.
homekit:
- name: HASS Bridge s42
port: 21063
filter:
include_domains:
- cover
- light
include_entity_globs:
- climate.heizung_*_int*
include_entities:
- climate.1e89f334
- sensor.landroid_oben_l1000_error
- sensor.landroid_unten_error
- switch.brunnen_socket_1
- fan.levoit_core300s
exclude_entities:
- light.shapes_e22c
- name: HASS Bridge Lock
port: 21064
mode: accessory
filter:
include_entities:
- lock.hausturoffner
Jede Instanz braucht einen eigenen Port. Hast du schon Bridges über die Oberfläche angelegt, belegen die ab 21064 aufwärts Ports. Wähl für deine YAML-Instanzen dann freie Ports, damit sich nichts in die Quere kommt.
Gerätetyp eines Schalters zur Steckdose ändern
Über entity_config ist es außerdem möglich, den Gerätetyp in HomeKit von einem Schalter beispielsweise auf eine Steckdose zu ändern. Wichtig: Die Entität kommt in die normale Bridge, nicht in die Zubehör-Instanz, denn im Zubehörmodus ist nur genau eine Entität erlaubt.
homekit:
- name: HASS Bridge s42
port: 21063
filter:
include_domains:
- cover
- light
include_entity_globs:
- climate.heizung_*_int*
include_entities:
- climate.1e89f334
- sensor.landroid_oben_l1000_error
- sensor.landroid_unten_error
- switch.brunnen_socket_1
- fan.levoit_core300s
- switch.office
exclude_entities:
- light.shapes_e22c
entity_config:
switch.office:
type: outlet
- name: HASS Bridge Lock
port: 21064
mode: accessory
filter:
include_entities:
- lock.hausturoffner
Natürlich switch.office durch deinen eigenen Switch ersetzen 😉
Geräte für HA
Mehr Geräte für Home Assistant, HACS oder auch Alexa, Google Home, HomeKit sowie Homebridge findest du in unserem Smart Home Gerätefinder!
Hardware für Home Assistant
Dein Home Assistant ist langsam, reagiert unzuverlässig oder stürzt ab? Du hast noch gar keinen am Laufen?
Im Beitrag unten findest du empfehlenswerten Hardware & Tipps, damit dein Home Assistant so richtig gut läuft und dein Smarthome schnell wie der Blitz wird 🚀
Fazit
Mit der HomeKit Bridge bekommst du deine Home Assistant Entitäten ohne Umweg über Homebridge in die Home App. Für den Einstieg reicht die Oberfläche: Domains auswählen, QR-Code scannen, fertig. Wenn du mehr Kontrolle willst, nimmst du YAML mit Filtern, Wildcard-Filtern, Ausnahmen und entity_config.
Du nutzt neben Apple Home auch andere Sprachassistenten? Dann schau dir auch an, wie du Home Assistant mit Alexa oder Google Home verbindest.
Wenn du Fragen hast oder auf Probleme bei der Einrichtung der HomeKit-Integration für dein eigenes Home Assistant-System stößt, melde dich gern unten in den Kommentaren. Ich werde mein Bestes tun, um dir zu helfen, damit alles richtig funktioniert.
Super Anleitung. Die Kameras als Accessory sind kein Problem, meinen Denon AV Receiver bringe ich nur leider nicht hin.
Da kommt einfach kein QR Code.
Konfiguriere ich ihn in der GUI klappt es. Zwar auch nicht so wie ich gern hätte – kann nicht nur 2 Quellen verwenden sondern muss alle nehmen und was noch unschöner ist: Lautstärke regeln Fehlanzeige.
Kann mir da vielleicht jemand einen Tipp geben für yaml und zumindest die Lautstärke
Hallo Simon,
Danke für deine fülle an Videos! TOP!!!
Nun eine kurze Frage, ich bekomme meine Fentserkontakte nicht in HomeKit eingebunden……… was mache ich falsch? Habe es auf zwei verschiedene Arten versucht…. beide ohne Erfolg…..
include_entities:
– binary_sensor.fensterkontakt_buro_links
– binary_sensor.fensterkontakt_badezimmer_oben
–
include_entity_globs:
– binary_sensor.fensterkontakt_*_*
Hallo Fabian,
ich habe das gleiche Problem. Hast du dafür in der Zwischenzeit eine Lösung gefunden?
Dank und Grüße
Hallo Simon
Wollte fragen ob es hierfür eine lösung gibt in Homeassistant mit Reolink doorbells. Auf der seite steht homebridge und dann das plugin camera ui installieren, geht das auch mit dem homebridge plugin in homeassistant?
*Laden Sie Homebridge herunter und installieren Sie es auf Ihrem PC oder Mac. Installieren Sie das Camera-UI-Plugin, indem Sie auf der Homebridge suchen.*
Danke für deine Antwort
Gruss Sandro
Hi Simon,
weißt du, ob/wie man es hinkriegen kann, dass Geräte, die in Home Assistant Bereichen zugeordnet sind, automatisch und korrekt in die (gleichlautenden) Räume von Home übernommen werden bzw. überhaupt über die Bridge möglichst schon „fertig konfiguriert“ in Home ankommen?
Die Geräte landen in Home ja immer zunächst im „Standardraum“ – manche bei mir komischerweise in „Büro“ (warum auch immer – vielleicht weil mein HA dort sitzt?!?) – und wollen dann einzeln konfiguriert werden.
Das wäre ja ansich auch kein großes Ding, wenn man die Konfiguration in Home tatsächlich nur einmalig machen müsste. Meine Erfahrung zeigt allerdings, dass das eben leider nicht der Fall ist: Bei mir war die Home Konfig jetzt schon 2x korrumpiert, d.h. ich musste die dann komplett neu aufbauen. Und da wird die manuelle Konfiguration eines jeden Geräts spätestens beim dritten Anlauf halt ziemlich nervig…
LG Renato
Hi Simon. Zuerst einmal vielen herzlichen Dank für Deine tollen Videos und Anleitungen. Du machst einen super Job! Ich habe da eine spezielle Frage. Bei uns sind 2 Netzwerke in Betrieb. Das „Normale“, wo auch mein iPhone und alle anderen Geräte verbunden sind und ein anderes, wo HomeAssistant und sämtliche Geräte dazu eingebunden ist. Nun stehe ich mit dem Problem da, dass ich die Bridge vom HA nicht in HomeKit integriert bekomme, da es 2 unterschiedliche Netzwerke sind. Ich habe 2 Ubiquiti UniFi AP im Einsatz.
Hallo Simon,
Ich habe von HomeMatic diverse Fensterkontakte im Einsatz.
(HMIP-SWDO und HmIP-SRH)
Diese werden auch in HA korrekt angezeigt. – auch wenn es eine Statusänderung gibt.
Des Weiteren nutze ich die HomeKit Integration.
Die Statusänderung der HMIP-SWDO Geräte wird mir in der Home App auch angezeigt. Die HmIP-SRH-Änderungen allerdings nicht.
Das manuelle anlegen einer HomeKit Integration und das hinterlegen der Entität, Neustart usw. brachte keinen Erfolg.
Woran kann es liegen, dass die Fensterdrehgriffkontakte in der Home App nicht angezeigt werden, die optischen Fensterkontakte aber schon?
Danke und viele Grüße
Martin
Hallo Martin!
Ich kämpfe grade mit ähnlichem Problem. Bin im Januar auf HA umgestiegen und verwende u.a. Fenstergriffe von Hoppe und Kontaktschalter von Eltako mit dem EnOcean-Protokoll. Die Einbindung in HA funktioniert einwandfrei. Leider bekomme ich die Geräte nicht in Homekit eingebunden. Entweder übersehe ich etwas wesentliches oder bin einfach überfordert. 🙂
Vielleicht hat jemand eine grundsätzliche Idee was ich prüfen oder testen könnte.
MfG Bernd
Hallo Simon,
vielen Dank für die lehrreichen Videos! Ich habe schon viel gelernt.
Eine Frage zur Homkit Integration:
Ich möchte zwei Sungrow Entitäten (aktueller Speicherladezustand und aktuelle PV Produktion) in Homkit integrieren, damit wir die Werte per Siri abfragen können und dafür kein iPhone benötigen.
Wenn ich ausschließlich die beiden Entitäten auswähle unter Konfiguration, erhalte ich beim Koppeln mit Homkit die Meldung „Gerät nicht gefunden“
Wie muss man vorgehen? Müssen die Entitäten besonders definiert werden in der configuration.yaml? Wenn ja, könntest Du mir beschreiben, wie?
Vielen Dank für den Support!
Hallo Simon,
wiederholt Danke für deine Videos.
Ich habe mir heute nochmal das Video bezüglich HomeKit Integration angeschaut. Dabei ist mir noch aufgefallen, dass ich vor kurzem ja den Studio Codeserver integriert habe und damit ein pflegen der Configuration.yaml oder des HomeKit.yaml include Datei super einfach ist.
Du musst die Entitäten nicht mehr vorher suchen… diese Verden dir im Coding vorgeschlagen. Also z.B. schreibst du light.wo… und es schlägt dir das Wohnzimmer Licht vor. Genial,
Hallo Simon, ich wechsel gerade zu Home Assistant und im Grunde funktioniert es laut Deiner Anleitung auch sehr gut. Leider bekomme ich die Power-Werte meiner Shelly-Plug-S nicht zu HomeKit übertragen. Als ich vorher HomeBridge genutzt habe, wurden die Werte zumindest in der EVE-App angezeigt. Mit der HA HomeKit-Bridge will es einfach nicht klappen. Welchen Sensor-Typ kann ich für die Übertragung von Power (Leistung) nutzen?
Hallo Simon, ich möchte gern FritzBox Entitäten wie Wifi On / Off mit ins Homekit bringen. Ist das möglich? Was genau muss ich tun, das die Entitäten wie Toogle angezeigt werden.
Home-Controller funktioniert aber nur it noch nicht gekoppleten Geräten, wenn ich das richtig deute. Ich möchte aber nicht meiner Geräte entkopllen, sondern lediglich auch Homekit zugreifen und die dort vorhandenen Geräte steuern oder auslesen.
So wie ich Apple kenne, wird das bestimmt nicht so einfach möglich sein.
Hi!
Ist es auch möglich Homekit-Geräte durch HA zu bedienen? Bisher funktionierte die Bridge ja immer nur ein eine Richtung.
Aber klar, schau dir mal den HomeKit-Controller an 🙂
Hi 🙋♂️
Ich weiß nicht ob ich diese frage übersehen habe. Ich bin jetzt bei OpenHAB würde aber gerne HA nutzen da ich aber noch in der Anfangsphase bin wollte ich eigentlich nur fragen ist es möglich „nicht HomeKit fähige Geräte über HA HomeKit fähig zu machen? Also ich habe Steckdosen von Meross die kein HomeKit Integration mitbringen.
LG
Exakt, genau dafür ist diese Integration hier 🙌
Hallo Simon, Danke erstmal für das Video. Ich habe ein kleines Problem und stehe etwas auf dem schlauch. Und zwar habe ich Hue-Deckenleuchten, welche ich in HomeKit steuern kann. Ich habe aber auch in jeden Lichtschalter auch einen Shelly und für den gerne im HomeKit bei der Hütte Entität für on/off nutzen. Kannst du mir helfen? Vielen Dank schon vorab
Super Video! Ich hätte allerdings die umgekehrte Frage – Gibt es einen Weg alle Homekit-Geräte ausschliesslich in Home-Assistant zu integrieren? Ich benutze Home Assistant nur für die Energieverwaltung und hätte gerne somit gerne alles was über meine Hubs und Matter in Homekit angebunden ist einfach in Home Assistant abgebildet. Finde dazu aber leider nichts im Netz :/
Hattest du das nicht schon auf YouTube gefragt?
Vielleicht komme ich auch durcheinander 😅
Hallo Simon, vielen Dank für deine tollen Videos, die haben mich manche Hürde im Hassio meistern lassen. Bei der Homekitintegration komme ich aber nicht weiter. Wenn ich nur den Eintrag in der yaml- Datei mache, woher bekomme ich dann den Code zum einbinden in Homekit auf dem Handy? Oder muss zusätzlich zu den Einträgen in der Yaml die Integration in Hassio hinzugefügt werden? Das habe ich zwar ausprobiert, dann wird mir aber nur die Bridge angezeigt mit einem anderen Port als den, den ich in der Configurations.yaml vorgegeben habe und es werden mehr Geräte als in der Yaml angegeben ins Homekit übernommen.
Nach dem Neustart von Home Assistant und dem Start der HomeKit-Integration wird der Code in der Seitenleiste als Benachrichtigung angezeigt (Mit dem Pairing-QR Code)
Hallo Simon, vielen Dank für deine Videos. Ich bin neu in der Welt von Home Assistant und zur Zeit noch sehr damit beschäftigt alle meine Geräte zu integrieren. Ich habe sehr viele Eve Geräte unter anderem auch zwei der Eve Room, die du im Video erwähnst, Eve Thermo, Eve Energy, Eve Weather und Eve Degree. Die Älteren Geräte z.B. von Eve Energy der Gen1+2 habe ich gar nicht über den HomeKit Controller einbinden können weshalb ich viele durch neue Geräte ersetzt habe.
Nun habe ich ein Problem besonders bei den Daten der Raumsensoren von Eve. Hier werden mir nur sehr sporadisch neue Sensordaten in Home Assistant angezeigt bzw. scheinen die Werte einzufrieren (siehe Bild). Der Luftfeuchtigkeitssensor im Schlafzimmer zum Beispiel zeigt seit zwei Tagen 1,8% an, obwohl auf dem Gerät eine ganz andere Luftfeuchtigkeit angezeigt wird.
Hattest du schon einmal ein ähnliches Problem oder hast davon gehört?
LG
Thimo
Hab ich leider keine Idee zu, sorry 😕
Vielleicht mal in der Home Assistant Community nachfragen 😅
Hi, kann man eigentlich homekitsteckdosen in homeassistant einbinden? also die andersrum variante?
Hi Andreas,
schau mal hier: https://www.home-assistant.io/integrations/homekit_controller/
Wenn ich die app versuche zu integrieren sagt er nur keine ungekoppelten Geräte gefunden.
Also noch mal zur erklärung, ich hab 2 Homekit Steckdosen. Mit diesem Scannerlogo drauf, Man kann das nicht irgendwie einfach scannen?
Danke für deine Hilfe.
Vergiss es, ich musste nur die Geräte aus Homekit entfernen, dann findet er sie auch, Danke
schönen guten tag =)
kleine frage, vielleicht kannst du mir ja helfen.ich habe die Tuya app in HA und einen Vorhang (curtain) in der smart life app, in HA funktioniert alle perfekt, der Vorhang geht auf und zu, nur in HomeKit funktioniert das nicht.
der knöpf Vorhang wird angelegt , funktioniert aber nicht ….höttest du vielleicht eine Idee ?
vielen dank =)
lg
christian =)
Hi Christian,
steht dazu vieleicht was im Log?
Leider nein , an dem Schalter steht auch dass es sieben unkonfigurierte schalter gibt .
Hab leider kein Gerät zum Testen, aber hast du dir mal die Beispielseite zur entity_config angesehen? Klingt für mich so als würde das fehlen:
https://www.home-assistant.io/integrations/homekit/#:~:text=%2D%20binary_sensor.living_room_motion-,entity_config%3A,-alarm_control_panel.home%3A