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?

KriteriumApple Home Kopplung (HAP)Matter Kopplung
ZielsystemeApple Home (iPhone, iPad, Mac, HomePod)Apple Home, Google Home, Alexa, SmartThings
ZubehörtypenAlle von Homebridge unterstützten GeräteAbhängig vom aktuellen Stand der Matter-Spezifikation
Kameras & TV-SteuerungVollständig unterstütztTeilweise noch nicht im Standard spezifiziert
Multi-AdminNur Apple HomeFreigabe an mehrere Systeme parallel
NetzwerkanforderungIPv4 / IPv6, mDNSZwingend IPv6 und mDNS im lokalen Netzwerk
EmpfehlungStandard für reine Apple-HaushalteWenn 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:

Matter-Kopplung Einstellungen in Homemanager
Matter-Optionen in Homemanager
  1. Öffne Homemanager und tippe unten auf den Tab System.
  2. Wähle deine Bridge aus und öffne Matter-Kopplung (Matter Pairing).
  3. Aktiviere den Schalter Matter aktivieren (Enable Matter).
  4. 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.

  5. Ü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.
  6. 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:

  1. Öffne das Homebridge-Webinterface im Browser und klicke auf Plugins.
  2. Achte auf das Matter-Badge auf der Plugin-Karte, um zu sehen, ob die Integration für Matter vorbereitet ist.
  3. Klicke auf das Schraubenschlüssel-Symbol und öffne die Brückeneinstellungen (Child Bridge).
  4. Wenn das Plugin als Child Bridge eingerichtet ist, kannst du hier Matter einschalten und bei Bedarf HomeKit (HAP) deaktivieren.
  5. Speichere die Einstellungen und starte die Child Bridge neu.
  6. 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.