Tutos 10 min de lecture

Automatiser l'ouverture d'un garage connecté avec Home Assistant en 2026

Relier une porte de garage motorisée à Home Assistant : capteur d'ouverture Zigbee pour connaître son état, module relais pour la commander, et automatisations prudentes (alerte si elle reste ouverte, lumière la nuit).

S Par Selfhostr · sans contenu sponsorisé
Automatiser l'ouverture d'un garage connecté avec Home Assistant en 2026
Cet article peut contenir des liens affiliés (sans surcoût pour toi, ça finance le site). En tant que Partenaire Amazon, Selfhostr réalise un bénéfice sur les achats remplissant les conditions requises. Voir la disclosure.

👍 On aime

  • État réel de la porte visible partout (appli, tableau de bord, notifications)
  • Commande depuis l'appli Home Assistant, sans télécommande
  • Tout reste en local : le réseau Zigbee ne dépend d'aucun cloud
  • Se combine avec l'éclairage, l'alarme ou la détection de présence

👎 On regrette

  • Il faut un module relais en plus du capteur pour commander la porte
  • Câblage sur le bornier de la motorisation : lire sa notice avant
  • Une commande à distance ne remplace pas les sécurités de la motorisation (cellules, détection d'obstacle)
📑 Sommaire ▾

Une porte de garage connectée, ce sont en réalité deux fonctions distinctes. Connaître son état (ouverte ou fermée) : c’est le rôle d’un capteur d’ouverture, ici le Sonoff SNZB-04P en Zigbee. La commander : c’est le rôle d’un module relais à contact sec, qui « appuie » à votre place sur le bouton mural de la motorisation. Ce tutoriel installe le coordinateur Zigbee dans Home Assistant (en conteneur Docker), ajoute le capteur, regroupe capteur et relais dans une entité « Garage », puis met en place des automatisations prudentes : une alerte quand la porte reste ouverte et l’éclairage la nuit. On n’automatise volontairement pas l’ouverture : une porte qui s’ouvre seule sur un faux déclenchement, c’est un garage ouvert à tout le monde.

Prérequis

  • Home Assistant installé en conteneur Docker (nommé homeassistant dans ce guide), avec Docker Compose
  • Un coordinateur Zigbee : ici le Sonoff Zigbee 3.0 USB Dongle Plus-E (ZBDongle-E)
  • Un capteur d’ouverture Zigbee : ici le Sonoff SNZB-04P
  • Pour commander la porte : un module relais à contact sec (Zigbee ou Wi-Fi) compatible avec Home Assistant, et une motorisation qui dispose d’un bornier pour bouton poussoir (voir sa notice)
  • Un accès SSH à la machine qui fait tourner Docker
  • L’interface de Home Assistant sur le port 8123 de votre réseau local (inutile de l’ouvrir sur Internet)

Installation pas à pas

Étape 1 : Brancher le coordinateur Zigbee et le passer au conteneur

Branchez le dongle sur un port USB, de préférence au bout d’une courte rallonge USB : un port USB 3 et le boîtier de la machine perturbent la bande 2,4 GHz. Repérez ensuite son chemin stable sur la machine hôte :

ls -l /dev/serial/by-id/

Une ligne contenant Sonoff ou ITead doit apparaître, avec un lien vers ttyUSB0 ou ttyACM0. Utilisez le chemin /dev/serial/by-id/... complet plutôt que ttyUSB0, qui peut changer au redémarrage. Ajoutez-le au service Home Assistant de votre docker-compose.yml :

services:
  homeassistant:
    # ... votre configuration actuelle (image, volumes, network_mode, etc.)
    devices:
      - /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_XXXXXX-if00-port0:/dev/zigbee

Remplacez la partie avant :/dev/zigbee par le chemin exact relevé plus haut, puis recréez le conteneur :

docker compose up -d homeassistant

Vérifiez la réussite :

docker exec homeassistant ls -l /dev/zigbee

Le périphérique doit être listé. Si la commande répond « No such file or directory », le chemin du fichier Compose ne correspond pas à celui de ls -l /dev/serial/by-id/.

Étape 2 : Ajouter l’intégration Zigbee Home Automation (ZHA)

Dans Home Assistant, ouvrez Paramètres > Appareils et services > Ajouter une intégration, puis choisissez Zigbee Home Automation. Indiquez le port /dev/zigbee quand l’assistant demande le périphérique série et laissez-le créer un nouveau réseau Zigbee. Le ZBDongle-E est un coordinateur Silicon Labs : si le type de radio est demandé, choisissez EZSP.

Vérifiez la réussite :

docker logs homeassistant --since 10m 2>&1 | grep -i -E "zha|zigbee" | tail -n 20

Aucune erreur de connexion au port ne doit apparaître, et l’intégration ZHA doit s’afficher dans Appareils et services avec le coordinateur comme premier appareil.

Étape 3 : Appairer le capteur d’ouverture SNZB-04P

Dans l’intégration ZHA, cliquez sur Ajouter un appareil. Mettez ensuite le SNZB-04P en mode appairage en maintenant son bouton jusqu’à ce que son voyant clignote (la durée exacte est indiquée dans sa notice). Le capteur apparaît en général en quelques secondes. Renommez son entité d’ouverture en binary_sensor.garage_porte pour pouvoir copier les exemples tels quels.

Fixez le capteur sur la porte et son aimant sur le dormant, alignés quand la porte est fermée. Sur une porte basculante ou sectionnelle, placez-le en haut de la porte, là où l’écart avec le cadre est le plus net à l’ouverture.

Vérifiez la réussite : ouvrez Outils de développement > États, cherchez binary_sensor.garage_porte, puis ouvrez et fermez la porte. L’état doit passer de off (fermée) à on (ouverte) et inversement.

Étape 4 : Câbler et ajouter le module relais

Le relais se branche en parallèle du bouton poussoir mural de la motorisation, sur les bornes prévues à cet effet (voir la notice de la motorisation). Coupez l’alimentation de la motorisation avant toute intervention. Ajoutez ensuite le relais à Home Assistant avec son intégration (ZHA s’il est en Zigbee) et renommez son entité en switch.garage_relais.

La plupart des motorisations attendent une impulsion : un contact bref, comme un appui sur le bouton. Si votre relais propose un mode « impulsion » (inching), activez-le. Sinon, le script ci-dessous fait l’impulsion lui-même. Créez-le dans Paramètres > Automatisations et scènes > Scripts > Ajouter un script, menu ⋮ > Modifier en YAML :

alias: "Garage - impulsion"
mode: single
sequence:
  - action: switch.turn_on
    target:
      entity_id: switch.garage_relais
  - delay: "00:00:01"
  - action: switch.turn_off
    target:
      entity_id: switch.garage_relais

Enregistrez-le sous l’identifiant garage_impulsion. Lancez-le une fois, porte en vue : la motorisation doit réagir comme à un appui sur le bouton.

Étape 5 : Créer l’entité « Garage »

Une entité de type cover réunit l’état (le capteur) et la commande (le script) dans une seule carte, avec les boutons ouvrir et fermer. Ajoutez ce bloc à configuration.yaml (dans le dossier de configuration monté dans le conteneur) :

template:
  - cover:
      - name: "Garage"
        device_class: garage
        state: "{{ 'open' if is_state('binary_sensor.garage_porte', 'on') else 'closed' }}"
        open_cover:
          - condition: state
            entity_id: binary_sensor.garage_porte
            state: "off"
          - action: script.garage_impulsion
        close_cover:
          - condition: state
            entity_id: binary_sensor.garage_porte
            state: "on"
          - action: script.garage_impulsion

La condition placée avant chaque impulsion évite qu’un appui sur « ouvrir » ne referme une porte déjà ouverte : la motorisation, elle, ne fait qu’inverser son mouvement à chaque impulsion.

Vérifiez la configuration avant de redémarrer :

docker exec homeassistant python -m homeassistant --script check_config --config /config

La commande ne doit signaler aucune erreur. Redémarrez ensuite Home Assistant (Paramètres > Système > menu d’alimentation > Redémarrer) : l’entité cover.garage apparaît, avec l’état de la porte et les deux boutons.

Étape 6 : Être alerté si la porte reste ouverte

C’est l’automatisation la plus utile au quotidien. Créez-la dans Paramètres > Automatisations et scènes > Créer une automatisation > Créer une nouvelle automatisation, menu ⋮ > Modifier en YAML. Remplacez notify.mobile_app_mon_telephone par le service de notification de votre téléphone (il apparaît une fois l’application Home Assistant installée et connectée) :

alias: "Garage resté ouvert"
triggers:
  - trigger: state
    entity_id: binary_sensor.garage_porte
    to: "on"
    for: "00:10:00"
actions:
  - action: notify.mobile_app_mon_telephone
    data:
      title: "Garage"
      message: "La porte du garage est ouverte depuis 10 minutes."

Vérifiez la réussite : laissez la porte ouverte un peu plus de 10 minutes. La notification doit arriver, et la trace d’exécution s’affiche dans l’automatisation (menu ⋮ > Traces).

Étape 7 : Allumer la lumière la nuit

Même méthode. Remplacez light.garage par votre éclairage :

alias: "Garage - lumière la nuit"
triggers:
  - trigger: state
    entity_id: binary_sensor.garage_porte
    from: "off"
    to: "on"
conditions:
  - condition: state
    entity_id: sun.sun
    state: "below_horizon"
actions:
  - action: light.turn_on
    target:
      entity_id: light.garage

Vérifiez la réussite : après le coucher du soleil, ouvrez la porte. La lumière doit s’allumer et la trace doit montrer la condition sun.sun validée.

Étape 8 (optionnel) : Fermeture programmée le soir

Si votre motorisation dispose de cellules photoélectriques et d’une détection d’obstacle en état de marche, vous pouvez la faire fermer à heure fixe quand elle a été oubliée. Sans ces sécurités, ne le faites pas.

alias: "Garage - fermeture du soir"
triggers:
  - trigger: time
    at: "22:30:00"
conditions:
  - condition: state
    entity_id: binary_sensor.garage_porte
    state: "on"
actions:
  - action: notify.mobile_app_mon_telephone
    data:
      message: "Porte du garage oubliée ouverte : fermeture en cours."
  - action: cover.close_cover
    target:
      entity_id: cover.garage

Vérifiez la réussite le premier soir : la notification doit arriver et la porte doit se fermer. Contrôlez ensuite dans les traces que la condition a bien été évaluée.

Vérifications

  • docker exec homeassistant ls -l /dev/zigbee liste le coordinateur
  • docker exec homeassistant python -m homeassistant --script check_config --config /config ne signale aucune erreur
  • Dans Outils de développement > États, binary_sensor.garage_porte suit les mouvements de la porte et cover.garage affiche open ou closed
  • Le bouton « fermer » de la carte Garage ne fait rien quand la porte est déjà fermée (la condition bloque l’impulsion)
  • Les automatisations des étapes 6 et 7 montrent une trace d’exécution après un essai réel

Sécurité et bonnes pratiques

Une commande de porte de garage est une clé de la maison. N’exposez pas le port 8123 directement sur Internet : passez par un VPN (WireGuard, Tailscale) ou par un reverse proxy en HTTPS. Activez l’authentification à deux facteurs pour les comptes Home Assistant et ne donnez pas de compte administrateur aux autres membres du foyer. Le réseau Zigbee (fichier zigbee.db et configuration de ZHA) est stocké dans le dossier de configuration de Home Assistant : sauvegardez-le régulièrement, par exemple avec tar czf ha-config-$(date +%F).tar.gz -C /chemin/vers config en adaptant le chemin à votre volume. Mettez Home Assistant à jour avec docker compose pull homeassistant && docker compose up -d homeassistant, après avoir lu les notes de version. Enfin, gardez la télécommande d’origine et le bouton mural : la domotique s’ajoute à la motorisation, elle ne la remplace pas.

Dépannage : erreurs courantes

  • ZHA ne trouve pas le coordinateur -> le périphérique n’est pas passé au conteneur -> vérifiez la section devices du fichier Compose et le résultat de docker exec homeassistant ls -l /dev/zigbee, puis recréez le conteneur.
  • Le capteur s’appaire puis se déconnecte -> portée insuffisante ou perturbations en 2,4 GHz -> éloignez le dongle de la machine avec une rallonge USB et ajoutez un appareil Zigbee alimenté sur secteur (prise ou relais), qui sert de répéteur.
  • La porte s’ouvre puis se referme aussitôt -> le relais reste fermé trop longtemps ou envoie deux impulsions -> désactivez le mode impulsion du relais si le script le fait déjà, ou l’inverse.
  • L’état de la porte est inversé -> capteur posé à l’envers ou aimant mal aligné -> ajustez la position. Le modèle state de l’étape 5 suppose on = ouverte.
  • check_config signale une erreur sur cover -> indentation YAML ou clé template: déjà présente ailleurs dans configuration.yaml -> regroupez tous les blocs sous une seule clé template:.

FAQ

Mon capteur Zigbee est-il compatible avec ZHA ?

La plupart des capteurs Zigbee 3.0 le sont. Pour un modèle précis, consultez la base de compatibilité communautaire zigbee.blakadder.com, qui indique pour chaque appareil s’il fonctionne avec ZHA et Zigbee2MQTT.

ZHA ou Zigbee2MQTT ?

Les deux fonctionnent avec le ZBDongle-E. ZHA est intégré à Home Assistant et suffit pour ce guide. Zigbee2MQTT demande un broker MQTT en plus, mais reconnaît souvent plus tôt les appareils récents et expose plus de réglages.

Peut-on se passer du module relais ?

Pour connaître l’état de la porte, oui : le capteur suffit, et les étapes 6 et 7 fonctionnent sans relais. Pour la commander depuis Home Assistant, il faut un relais, ou une motorisation qui possède sa propre intégration Home Assistant.

Comment limiter les interférences avec le Wi-Fi ?

Zigbee et Wi-Fi partagent la bande 2,4 GHz. Les canaux Zigbee 15, 20 et 25 sont ceux qui recouvrent le moins les canaux Wi-Fi 1, 6 et 11. Une rallonge USB pour éloigner le dongle de la machine aide autant que le choix du canal.

A lire aussi

Chiffres-clés

~45 min
Durée
Intermédiaire
Difficulté
Modéré
Coût
Home Assistant en conteneur Docker + porte de garage motorisée
Prérequis clé

Notre sélection

Liens affiliés · prix identique pour toi
Recommandé
Sonoff Zigbee 3.0 USB Dongle Plus-E (ZBDongle-E)

Sonoff Zigbee 3.0 USB Dongle Plus-E (ZBDongle-E)

Voir sur Amazon

Amazon · prix et disponibilité sur la fiche

Recommandé
📦

Sonoff SNZB-04P

Voir sur Amazon

Amazon · prix et disponibilité sur la fiche

Retrouve tout notre matériel recommandé dans la boutique.

Tags : home assistantauto-hébergementzigbeeautomatisationgarage

Sur le même sujet

Tutos

Mesurer la consommation électrique de son homelab et de son NAS en 2026

Wattmètre Brennenstuhl PM 231 E, prise connectée (Shelly Plug S Gen3, Nous A1Z, Aqara) ou Shelly EM Gen3 au tableau : mesurer ce que consomment NAS et serveurs, l'historiser dans Home Assistant et réduire la facture.

Lire
Tutos

Installer Ollama avec Docker sur un mini-PC en 2026 : modèles, API et limites

Installer Ollama dans Docker sur un mini-PC Linux, télécharger un premier modèle, interroger l'API sur le port 11434, la protéger, et savoir ce qu'un Intel N100 avec 16 Go de RAM peut faire tourner sans GPU.

Lire
Tutos

Home Assistant sur mini-PC en 2026 : clé Zigbee et sauvegardes

Installer Home Assistant Container avec Docker Compose sur un mini-PC Linux, ajouter une clé ConBee III via ZHA, configurer les sauvegardes automatiques chiffrées, le HTTPS local avec Caddy et la double authentification.

Lire