Installer Home Assistant Docker en 2026: Guide Pas à Pas

Dans ce tutoriel, nous allons installer Home Assistant sur votre système avec Docker. Home Assistant est un hub domotique open-source qui permet de contrôler et gérer tous vos appareils intelligents via une interface web simple et intuitive. Nous utiliserons docker-compose pour configurer l’environnement et un dongle Zigbee pour intégrer des capteurs sans fil à votre homelab. À la fin, vous aurez un système entièrement fonctionnel avec Home Assistant configuré pour contrôler vos appareils domestiques.

Prérequis

Système d’exploitation compatible (ex: Ubuntu 24.04 LTS)
Dongle Zigbee USB
Nom de domaine (optionnel)
Ports réseau ouverts (8123 pour l’accès web, 9443 pour la configuration avancée)
Docker installé et fonctionnel

Installation pas à pas

Étape 1 : Préparation du dossier de travail

cd ~
git clone https://github.com/home-assistant/example-config.git home-assistant
mkdir -p /etc/docker-compose.d

Vérifiez que le répertoire home-assistant a été créé et contient les fichiers nécessaires pour la configuration de Home Assistant.

Étape 2 : Création du fichier docker-compose.yml

topologie:
 image: homeassistant/home-assistant:rpi4-homeassistant-frontend
 container_name: topologie
 hostname: home-assistant
 environment:
 - TZ=Europe/Paris
 volumes:
 - /etc/docker-compose.d:/config
 - ~/home-assistant/config:/config
 ports:
 - 8123:8123/tcp

Vérifiez que le fichier docker-compose.yml est correctement configuré et qu’il ne contient pas d’erreurs de syntaxe.

Étape 3 : Configuration Caddy pour HTTPS (Facultatif)

topologie {
 reverse_proxy home-assistant:8123
}

Vérifiez que le fichier Caddyfile est correctement configuré et qu’il ne contient pas d’erreurs de syntaxe.

Étape 4 : Démarrage de Home Assistant avec Docker Compose

docker-compose up -d

Utilisez la commande suivante pour vérifier que le container Home Assistant est en cours d’exécution: docker ps | grep home-assistant

Étape 5 : Ajout du dongle Zigbee USB

Modifiez le fichier configuration.yaml pour inclure la configuration de votre dongle Zigbee:

mqtt:
 broker: tcp://localhost:1883
 discovery: true
device_tracker:
 platform: zeroconf
automation:
 - alias: "Activate Zigbee2MQTT"
 trigger:
 platform: mqtt
 topic: zigbee2mqtt/bridge/state
 action:
 service: mqtt.publish
 data_template:
 topic: zigbee2mqtt/config/node_01/device_options
 payload: "{\"auto_renew\":true}",

Vérifiez que le dongle Zigbee est correctement reconnu par Home Assistant en allant sur l’interface web à l’adresse http://localhost:8123 et en vérifiant la section ‘Configuration > Capteurs’.

Étape 6 : Configuration finale et utilisation

Vérifiez que tous les services Docker sont correctement configurés avec docker-compose ps. Accédez à l’interface web de Home Assistant pour configurer vos appareils et capteurs.

Vérifications

Utilisez la commande suivante pour vérifier le bon fonctionnement du container Home Assistant: docker logs topologie La sortie attendue doit indiquer que les services Home Assistant ont démarré sans erreurs. Vérifiez également que vous pouvez accéder à l’interface web de Home Assistant via http://localhost:8123.

Sécurité et bonnes pratiques

Pour sécuriser votre installation, configurez HTTPS avec Caddy ou un autre serveur reverse-proxy SSL-compatible. Utilisez des mots de passe forts et activez la double authentification (2FA) si disponible. Assurez-vous que Docker est configuré pour mettre à jour automatiquement les images Home Assistant via une commande crontab ou task scheduler.

Dépannage : erreurs courantes

Symptôme: Le container Home Assistant ne démarre pas.
Cause: Un problème de configuration dans le fichier docker-compose.yml.
Correctif: Vérifiez les entrées du fichier pour des erreurs de syntaxe ou des chemins incorrects.
Symptôme: L’interface web Home Assistant ne répond pas.
Cause: Le serveur MQTT n’est pas démarré correctement.
Correctif: Vérifiez que le service MQTT est en cours d’exécution et bien configuré dans la configuration YAML de Home Assistant.
Symptôme: Les capteurs Zigbee ne sont pas reconnus par Home Assistant.
Cause: Le dongle Zigbee n’est pas correctement configuré ou connecté.
Correctif: Vérifiez les connexions USB et la configuration du dongle dans le fichier configuration.yaml.

FAQ

Quel est l’avantage de Docker pour Home Assistant ?

Docker permet une installation simplifiée et isolée, avec des mises à jour faciles via docker-compose.

Comment configurer la sécurité supplémentaire pour Home Assistant ?

Utilisez HTTPS avec Caddy ou un autre reverse-proxy SSL-compatible. Configurez aussi la double authentification (2FA).

Quel est le dongle Zigbee recommandé ?

Pour des performances optimales, nous vous recommandons l’utilisation d’un dongle Zigbee USB de marque bien établie.

Comment mettre à jour Home Assistant via Docker ?

Utilisez la commande docker-compose pull pour mettre à jour les images et docker-compose up -d --force-recreate pour redémarrer le container avec la nouvelle version.

A lire aussi

Heberger ce service

Pas envie de gerer le materiel ni la maintenance ? Ce type de service s’auto-heberge sur un VPS manage, pret en quelques minutes. Voir les offres PlanetHoster