Introduction

Pour piloter des équipements Home Assistant depuis une enceinte Amazon Echo (Alexa), Apple Home ou Google Home sans passer par un cloud tiers ni payer d’abonnement, il est possible d’utiliser un pont Matter local.

Le conteneur home-assistant-matter-hub (repris par RiDDiX sur https://github.com/riddix/home-assistant-matter-hub/pkgs/container/home-assistant-matter-hub) fait directement le pont entre Home Assistant et les assistants vocaux du réseau local.

–> L’alternative idéale à ha-bridge (BWS Systems) et au pont Philips Hue émulé sur le port 80 : Tous ceux qui ont connu l’époque de ha-bridge ou de l’intégration Emulated Hue — qui simulaient un vieux pont Philips Hue v1 en local sur le port TCP 80 — savent que ces solutions ne fonctionnent plus avec les mises à jour récentes des enceintes Amazon Echo. Pour celles et ceux qui cherchent encore à faire tourner ce vieux pont sur le port 80 (souvent en conflit avec un reverse-proxy Nginx, Caddy ou Traefik), home-assistant-matter-hub est l’alternative moderne par excellence : elle s’appuie sur le standard officiel Matter (UDP 5540), fonctionne nativement avec tous les Echo récents et ne nécessite plus d’exposer le port 80.

Caractéristiques

Fonctionnement du pont

Le principe est simple :

• Le conteneur se connecte à Home Assistant via un jeton d’accès longue durée (Long-Lived Access Token).
• Il filtre les entités choisies (par exemple uniquement le domaine light ou un label précis).
• Il génère un QR Code Matter que l’application Alexa (ou Apple Home) scanne sur le réseau local.

Installation avec Docker Compose

Matter s’appuie sur le multicast mDNS (port UDP 5353) et IPv6 Link-Local pour être détecté par les enceintes Echo. Il faut donc utiliser network_mode: host et cibler l’interface réseau locale (eth0).

services:
  matter-hub:
    image: ghcr.io/riddix/home-assistant-matter-hub:latest
    container_name: home-assistant-matter-hub
    restart: unless-stopped
    network_mode: host
    environment:
      - HAMH_HOME_ASSISTANT_URL=http://127.0.0.1:8123
      - HAMH_HOME_ASSISTANT_ACCESS_TOKEN=votre_token_longue_duree
      - HAMH_HTTP_PORT=8482
      - HAMH_LOG_LEVEL=info
      - HAMH_MDNS_NETWORK_INTERFACE=eth0
    volumes:
      - ./data:/data

–> Si le serveur possède plusieurs cartes réseau ou des VLANs, préciser HAMH_MDNS_NETWORK_INTERFACE=eth0 évite que le pont diffuse ses annonces sur la mauvaise interface.

Points d’attention

Pour que l’appairage fonctionne du premier coup :

• L’enceinte Alexa et l’interface du serveur doivent être sur le même sous-réseau (ou avoir un réflecteur mDNS actif).
• Le pare-feu local du serveur doit autoriser les ports UDP 5353 (mDNS) et UDP/TCP 5540 (sessions Matter) uniquement depuis le réseau local.
• Il est préférable de n’exposer que les lumières ou prises utiles via un filtre ou un label dans l’interface Web (http://IP_SERVEUR:8482) pour ne pas saturer l’application Alexa.

Conclusion

Ce conteneur remplace avantageusement les anciens ponts émulés devenus incompatibles. En quelques lignes de Docker Compose, les équipements Home Assistant remontent en local dans Alexa ou Apple Home avec une réponse instantanée.

Plus d’informations sur le dépôt : https://github.com/ravindrajob/InfraAtHome