Dokumentation
Hinweis zur Verwendung von Matter unter Docker
- Generell empfehlen wir die Matter-Integration nicht unter Docker zu verwenden, da es hier diverse Anforderungen und Einschränkungen gibt, die teilweise auch sehr technisch und spitzfindig sind.
- Synology/QNAP NAS haben einen zu alten Kernel, sodass dort Thread Geräte gar nicht, und LAN/WLAN Geräte nur im Host/MacVLAN Netzwerk-Modus laufen können.
Wenn Matter unter Docker verwendet werden soll, muss eine der beiden Voraussetzungen erfüllt sein:
- Docker läuft im MacVLAN Netzwerk-Modus, sodass der Container eine eigene IP-Adresse im Netzwerk hat.
- Docker läuft im Host Netzwerk-Modus. Der Host darf dabei kein Avahi installiert haben. Ansonsten gibt es Server-Collision Fehlermeldungen und die mDNS Netzwerkauflösung wird nicht zuverlässig sein, da zwei Avahi-Stacks parallel laufen.
Bei folgenden Einschränkungen funktioniert Matter trotzdem nicht zuverlässig:
- Docker im Bridge Netzwerk-Modus funktioniert gar nicht, da mDNS dadurch nicht verfügbar ist.
- Docker läuft zwar korrekt im Host Netzwerk-Modus, aber Avahi läuft ebenfalls auf dem Host. Dadurch läuft Avahi doppelt. Dies ist insbesondere bei Synology/QNAP NAS der Fall. Dadurch wird das Finden der Geräte über mDNS gestört und Geräte werden sporadisch nicht erreichbar bzw. unzuverlässig sein.
- Wenn der Kernel zu alt ist werden keine Router Announcements unterstützt. Dies ist insbesondere bei Synology/QNAP NAS der Fall. In diesem Fall funktioniert die Matter-Integration nur für LAN/WLAN Geräte und für Thread Geräte nur, wenn ein IPv6-DHCP-Server verfügbar ist, der alle Adressen/Routen korrekt an alle Geräte/Thread Border Router vergibt.
- Falsch oder nicht gesetzte Sysctl-Einstellungen. Darauf weist der Konfigurator auch entsprechend hin. Dadurch werden insbesondere die Router Announcements konfiguriert, sodass Thread Geräte zuverlässig funktionieren.