Matter & Homebridge
Wie Matter und Homebridge zusammenarbeiten, wie Homebridge 2.0 Matter nativ unterstützt und wie du Matter in Homemanager oder im Webinterface einrichtest.
Matter und Homebridge
Matter ist ein herstellerübergreifender Standard, mit dem sich Smart-Home-Zubehör plattformübergreifend in Apple Home, Google Home und Amazon Alexa einbinden lässt.
Seit Version 2.0 unterstützt Homebridge Matter direkt. Zubehör lässt sich dadurch wahlweise über das klassische HomeKit Accessory Protocol (HAP) oder als natives Matter-Gerät im Netzwerk bereitstellen.
Wo Homebridge weiterhin gebraucht wird
Auch wenn immer mehr neue Geräte mit Matter auf den Markt kommen, löst der Standard typische Aufgaben von Homebridge nicht ab:
- Geräte ohne Firmware-Update: Ältere Fernseher, Steckdosen, Rollos oder Saugroboter erhalten von den Herstellern fast nie nachträgliche Matter-Updates. Homebridge bindet diese Bestandsgeräte weiterhin in Apple Home ein.
- Kameras und Türklingeln: Für Sicherheitskameras und Videostreams ist der Matter-Standard noch sehr eingeschränkt. Homebridge liefert für RTSP-Kameras und Türklingeln funktionierende Livestreams, Bewegungsmeldungen und Bild-in-Bild auf dem Apple TV.
- Virtuelle Schalter und Automationen: Reine Software-Hilfsmittel wie Timer, Dummy-Schalter oder Webhook-Empfänger gibt es in Matter nicht, weil das Protokoll auf physische Hardware ausgelegt ist.
Technische Grundlagen in Homebridge 2.0
Homebridge unterscheidet auf Plugin-Ebene zwei Übertragungswege (Transports):
- HAP (HomeKit): Das bewährte Protokoll für Apple Home.
- Matter: Das herstellerübergreifende Protokoll für parallele Nutzung in mehreren Systemen.
Entwickler kennzeichnen kompatible Erweiterungen in der package.json mit den Schlüsselwörtern supports-hap, supports-matter oder beiden Einträgen. Details dazu dokumentiert das Homebridge GitHub Wiki.
Im Homebridge-Webinterface (ab Version 5.28.0) sind entsprechende Integrationen mit einem Matter-Badge markiert. Wenn ein Plugin ausschließlich Matter unterstützt, schaltet Homebridge das HAP-Protokoll für diese Bridge automatisch ab, damit in der Home-App kein funktionsloser HAP-Kopplungscode entsteht. Wie du passende Plugins suchst und installierst, erfährst du in der Anleitung zu Plugins finden und einrichten.
Apple Home Kopplung oder Matter Kopplung?
| Kriterium | Apple Home Kopplung (HAP) | Matter Kopplung |
|---|---|---|
| Zielsysteme | Apple Home (iPhone, iPad, Mac, HomePod) | Apple Home, Google Home, Alexa, SmartThings |
| Zubehörtypen | Alle von Homebridge unterstützten Geräte | Abhängig vom aktuellen Stand der Matter-Spezifikation |
| Kameras & TV-Steuerung | Vollständig unterstützt | Teilweise noch nicht im Standard spezifiziert |
| Multi-Admin | Nur Apple Home | Freigabe an mehrere Systeme parallel |
| Netzwerkanforderung | IPv4 / IPv6, mDNS | Zwingend IPv6 und mDNS im lokalen Netzwerk |
| Empfehlung | Standard für reine Apple-Haushalte | Wenn Geräte in mehreren Plattformen gleichzeitig laufen sollen |
Wenn du dein Zuhause ausschließlich über Apple-Geräte steuerst, ist die klassische Apple Home Kopplung meist die verlässlichere Wahl. HAP ist für Homebridge seit Jahren erprobt und deckt alle Spezialfunktionen ab.
Wichtige Netzwerkvoraussetzungen: IPv6
Matter stellt im Vergleich zur klassischen HomeKit-Kopplung strengere Anforderungen an dein lokales Netzwerk:
- Zwingend aktives IPv6: Matter-Geräte und Smart-Home-Zentralen (wie HomePod oder Apple TV) kommunizieren ausschließlich über IPv6. Wenn IPv6 im Router, im Host-System oder im Docker-Container deaktiviert ist, schlägt das Koppeln fehl.
- Multicast DNS (mDNS): Router dürfen Multicast-Traffic im lokalen Netzwerk nicht blockieren. Gastnetzwerke eignen sich daher grundsätzlich nicht für Homebridge oder Matter.
Treten Verbindungsabbrüche auf, hilft ein Blick in den Leitfaden Zubehör reagiert nicht beheben.
Matter-Kopplung einrichten
Matter lässt sich wahlweise direkt auf iPhone und iPad mit Homemanager, im Homebridge-Webinterface (Config UI X) oder direkt in der Konfigurationsdatei aktivieren.
Einrichtung in Homemanager
In Homemanager findest du alle Koppel-Optionen gebündelt unter System:

- Öffne Homemanager und tippe unten auf den Tab System.
- Wähle deine Bridge aus und öffne Matter-Kopplung (Matter Pairing).
- Aktiviere den Schalter Matter aktivieren (Enable Matter).
Zubehör-Bridges eingrenzen: Mit Nur für Zubehör-Bridges aktivieren (Enable only for accessory bridges) beschränkst du Matter gezielt auf separat veröffentlichte Zubehöre wie Smart-TVs oder externe Kameras. Die übergeordnete Bridge bleibt dadurch auf HomeKit.
- Über Zubehör-Bridges verwalten (Manage accessory bridges) siehst und steuerst du diese ausgelagerten Zubehör-Bridges zentral, auch wenn sie von einer Child Bridge bereitgestellt werden.
- Kopiere den angezeigten Kopplungscode und binde die Bridge oder das Zubehör in Apple Home, Google Home oder Alexa als Matter-Gerät ein.
Einrichtung im Homebridge Webinterface (Config UI X)
Im Webinterface verwaltest du die Protokolle in den Einstellungen des jeweiligen Plugins:
- Öffne das Homebridge-Webinterface im Browser und klicke auf Plugins.
- Achte auf das Matter-Badge auf der Plugin-Karte, um zu sehen, ob die Integration für Matter vorbereitet ist.
- Klicke auf das Schraubenschlüssel-Symbol und öffne die Brückeneinstellungen (Child Bridge).
- Wenn das Plugin als Child Bridge eingerichtet ist, kannst du hier Matter einschalten und bei Bedarf HomeKit (HAP) deaktivieren.
- Speichere die Einstellungen und starte die Child Bridge neu.
- Nach dem Neustart findest du dort den Matter-QR-Code und den Kopplungscode. Bereits verbundene Systeme (Fabrics) listet das Webinterface ebenfalls übersichtlich auf.
Manuelle Konfiguration in der config.json
In der config.json wird Matter über ein eigenes Objekt innerhalb der Bridge- oder Child-Bridge-Konfiguration definiert:
{
"platforms": [
{
"platform": "BeispielPlattform",
"name": "Smarte Lampen",
"_bridge": {
"username": "0E:2A:4B:11:22:33",
"port": 51830,
"matter": {
"enabled": true
}
}
}
]
}Nach dem Neustart von Homebridge erscheinen die Matter-Pairing-Daten im Server-Log.
Einschränkungen in der Praxis
Bevor du ein Setup auf Matter umstellst, solltest du zwei Punkte beachten:
- Plugin-Unterstützung: Nicht jedes Plugin unterstützt Matter. Zubehör lässt sich nur exportieren, wenn das Plugin die Schnittstelle von Homebridge 2.0 unterstützt oder kompatible Standardtypen bereitstellt.
- Abweichender Funktionsumfang: Funktionen können sich zwischen HAP und Matter unterscheiden. Bestimmte Sensortypen oder Schalter-Optionen, die in Apple Home über HomeKit seit langem funktionieren, sind in der Matter-Spezifikation teilweise noch anders oder gar nicht vorgesehen.
Mit Apple Home koppeln
Schritt-für-Schritt-Anleitung für das klassische HomeKit-Pairing mit iPhone und iPad.
Child Bridges einrichten
Erfahre, wie isolierte Prozesse die Stabilität erhöhen und gezielte Matter-Freigaben ermöglichen.
Plugins finden und verwalten
Erfahre, wie du verifizierte Erweiterungen mit nativer Matter-Unterstützung entdeckst.
Server startet nicht & Logs analysieren
Startprobleme bei Homebridge beheben: Logs in Homemanager oder im Terminal lesen und typische Port- oder Syntaxfehler gezielt korrigieren.
App FAQ & Hilfe
Antworten auf häufige Fragen zur Homemanager App: Unterschiede zur Weboberfläche, Verbindungsprobleme, Fernzugriff, Matter und Lizenzen.