Dans le premier article de cette série, je vous ai expliqué pourquoi j'ai quitté le tout-cloud pour Home Assistant, et comment choisir son matériel et son protocole domotique. Place à la pratique. Ici, je vous montre comment installer réellement Home Assistant OS, que vous partiez sur un mini PC dédié ou sur une machine virtuelle hébergée par un NAS, puis comment faire vos premiers pas dans l'interface, avant de mettre en place le réseau Zigbee avec Zigbee2MQTT. Le troisième article de la série sera consacré aux automatisations concrètes : chauffage, sécurité et caméras.
Haos face aux autres façons d'installer home assistant
Avant de se lancer, une question se pose : quel système installer ? Le logiciel Home Assistant Core peut tourner comme un simple script Python sur n'importe quelle distribution Linux. Certains préfèrent d'ailleurs partir sur du Debian classique pour y déployer les briques logicielles à la main.
De mon côté, j'ai choisi Home Assistant OS (HAOS), qui s'est imposé comme une évidence. Contrairement à une distribution tierce qui oblige à gérer soi-même les dépendances système, les correctifs de sécurité et les configurations réseau en ligne de commande, HAOS est un système minimaliste et clé en main, entièrement optimisé pour une seule tâche. Une fois installé, HAOS déploie Home Assistant Core par-dessus, avec son mécanisme d'extensions (les add-ons) qui permet d'installer en un clic un serveur de base de données, un outil de sauvegarde ou un broker MQTT. On garde la stabilité d'un appareil industriel sans la maintenance fastidieuse d'un Linux classique.
Installer haos sur un mini pc, la méthode la plus directe
Si vous suivez ma recommandation du premier article et partez sur un mini PC dédié, l'installation se fait en mode bare metal, c'est-à-dire directement sur le SSD de la machine, sans couche de virtualisation. La méthode la plus propre consiste à extraire temporairement le SSD du mini PC et à le brancher sur votre ordinateur principal via un adaptateur USB vers NVMe ou SATA.
Il suffit ensuite d'utiliser le logiciel gratuit BalenaEtcher, de lui indiquer l'adresse de l'image officielle de Home Assistant OS pour architecture x86-64 disponible sur le site officiel de Home Assistant, et de lancer le flashage directement sur le SSD.
Une fois l'opération terminée, on réinstalle le SSD dans le mini PC, on branche un câble Ethernet ainsi que le contrôleur Zigbee (via une rallonge, j'y reviens plus loin), et on allume la machine. Le système s'éveille, configure ses partitions de manière autonome et déploie Home Assistant Core en tâche de fond. Moins de dix minutes plus tard, le serveur est accessible sur le réseau local à l'adresse http://homeassistant.local:8123. Pour les machines dont le SSD est impossible à extraire, il reste possible de démarrer sur une clé USB Ubuntu Live et d'écrire l'image via la ligne de commande dd, mais le flashage direct reste nettement plus simple.
Installer haos en machine virtuelle sur un nas
Si vous préférez virtualiser sur un NAS déjà en place, la logique change un peu. Sur un NAS Synology par exemple, tout se passe dans l'application Virtual Machine Manager, disponible dans le Centre de paquets de DSM. La première étape consiste à récupérer l'image disque virtuelle officielle de Home Assistant OS, au format OVA pour un environnement Synology, sur le site officiel du projet.
Dans Virtual Machine Manager, on se rend dans le menu Image, on clique sur Ajouter, puis Télécharger le fichier depuis l'ordinateur local pour charger le fichier OVA, en sélectionnant le volume de stockage le plus rapide disponible (idéalement un SSD, jamais un simple disque dur mécanique pour ce type d'usage). Une fois l'image importée, on crée la machine virtuelle proprement dite : menu Machine virtuelle, flèche à côté du bouton Créer, option Importer, puis on coche Importer à partir d'images de machines virtuelles et on sélectionne l'image stockée.
C'est à l'étape Configurer les spécifications générales que l'on alloue les ressources : deux cœurs de processeur virtuel et 4 Go de mémoire vive suffisent largement pour une installation courante. On définit ensuite la taille du disque virtuel, 32 Go étant un minimum confortable, avant de configurer le réseau et le passthrough USB de votre contrôleur Zigbee dans l'onglet Autre. Il suffit alors de sélectionner la machine dans la liste, de cliquer sur Action puis sur Allumer.
Un point technique à surveiller si vous êtes sur Synology : les pilotes de stockage disponibles (IDE, SATA, VirtIO SCSI) n'offrent pas du tout les mêmes performances. Sur un test avec un SSD NVMe, l'écart peut aller du simple au double entre IDE et VirtIO SCSI. Privilégiez systématiquement VirtIO SCSI si l'option est proposée.
Le piège des interférences usb sur le contrôleur zigbee
Voici le principal piège matériel de ce type d'installation, celui qui peut vraiment faire perdre patience. Si vous branchez votre clé Zigbee directement sur un port USB à même le châssis d'un NAS ou d'un mini PC, il arrive qu'aucun périphérique ne parvienne à s'appairer, alors que le système indique pourtant que le contrôleur fonctionne normalement.
La cause est purement physique : les ports USB 3.0 génèrent un bruit électromagnétique dans la bande des 2,4 GHz, la même que celle du Zigbee, qui vient noyer le signal radio minuscule de la clé. Il faut donc déporter le contrôleur avec une rallonge USB. Un minimum de 50 centimètres est généralement conseillé ; personnellement, je suis parti sur un câble de 3 mètres pour éloigner au maximum l'antenne des sources de bruit, et le problème a disparu instantanément.
Premiers pas dans l'interface
Le serveur est en ligne, la clé de communication branchée via sa rallonge. Il est temps d'entrer dans l'environnement logiciel qui va centraliser votre maison.
Connexion et assistant de démarrage
Ouvrez votre navigateur habituel depuis un appareil connecté au même réseau local, et saisissez http://homeassistant.local:8123. Si la résolution de noms mDNS pose problème sur votre réseau, remplacez cette adresse par l'IP fixe attribuée à la machine, par exemple http://192.168.1.50:8123.
L'assistant de configuration initiale vous demande de créer le compte administrateur (choisissez un mot de passe robuste, ce compte détient les clés numériques de votre logement), puis de définir la langue et la zone géographique. Vient ensuite la localisation de votre maison sur une carte : une information purement locale, stockée uniquement sur votre serveur, mais indispensable pour calculer les heures de lever et de coucher du soleil, qui serviront de déclencheur à de nombreuses automatisations. L'assistant se termine par un scan du réseau qui propose d'intégrer d'un clic les appareils déjà détectés : téléviseur connecté, enceintes, box internet.
Le tableau de bord et l'application mobile
Une fois l'assistant validé, vous arrivez sur l'interface principale, historiquement baptisée Lovelace. Par défaut, Home Assistant génère un tableau de bord automatique qui regroupe tout ce qu'il trouve, souvent dans un joyeux désordre au début, mais qui permet de vérifier d'un coup d'œil que le matériel répond bien.
L'étape suivante consiste à installer l'application officielle Home Assistant depuis le Play Store ou l'App Store. Au premier lancement, elle recherche le serveur sur le réseau Wi-Fi local et s'y connecte automatiquement. Au-delà de l'interface tactile, l'application transforme votre smartphone en véritable capteur domotique : niveau de batterie, connexion à tel ou tel Wi-Fi, et surtout position géographique pour déclencher des scénarios d'absence ou d'approche.
Configurer un accès à distance
Piloter sa maison depuis son canapé est une chose, garder le contrôle à l'autre bout du monde en est une autre. La méthode la plus simple et la plus sûre reste l'abonnement cloud de Nabu Casa, qui évite d'ouvrir le moindre port sur votre box et fournit une URL chiffrée de bout en bout, en plus de financer le développement du logiciel.
Pour ceux qui préfèrent une solution gratuite, une alternative solide consiste à utiliser Tailscale, qui crée un réseau privé virtuel chiffré entre vos appareils. En installant l'add-on correspondant sur Home Assistant, votre smartphone accède au serveur comme s'il était resté connecté au Wi-Fi de la maison, sans ouvrir de port non plus. D'autres méthodes existent, comme un reverse proxy avec Nginx Proxy Manager, les tunnels Cloudflare, ou un serveur VPN autonome type WireGuard, mais elles demandent de bonnes bases en administration réseau.
Le lexique indispensable de home assistant
Pour ne pas se perdre dans les menus, il faut connaître quatre notions de base.
- Intégration
- C'est la brique de code qui permet à Home Assistant de comprendre un protocole, une marque ou un service en ligne. Il existe des intégrations pour le Zigbee, pour Philips Hue ou pour récupérer les données de Météo France.
- Appareil
- C'est la représentation logique d'un objet physique global. Une multiprise connectée, une sonde de température extérieure ou votre smartphone sont des appareils.
- Entité
- C'est la variable unitaire rattachée à un appareil. Une sonde de température expose ainsi une entité température, une entité humidité et une entité batterie. Ce sont les entités qu'on manipule dans les graphiques et les automatisations.
- Entrée
- Ce sont des entités virtuelles créées de toutes pièces par l'utilisateur pour servir de variables logiques dans le système : un booléen pour simuler un mode vacances, un sélecteur de nombres pour une consigne de température théorique, un texte libre.
Ajouter une intégration ou un appareil
Pour un objet connecté en réseau, direction Paramètres, puis Appareils et services, et le bouton Ajouter une intégration en bas à droite. On saisit la marque du matériel et on laisse l'assistant guider la saisie des identifiants ou de l'adresse IP.
Pour du matériel Zigbee géré via Zigbee2MQTT, la logique diffère un peu : il faut ouvrir l'interface de Zigbee2MQTT depuis la barre latérale, cliquer sur Activer l'appairage, puis mettre le module physique en mode association en maintenant son bouton enfoncé quelques secondes. Le module apparaît, s'associe au réseau maillé, et ses entités remontent instantanément dans Home Assistant.
Créer ses pièces et ses premières automatisations
Avant de vous lancer dans des scénarios complexes, organisez votre logement dans Paramètres, puis Pièces, étiquettes et zones. Une fois vos pièces créées, vous pourrez y affecter vos appareils, ce qui permet à Home Assistant de comprendre des ordres globaux comme éteindre d'un coup toutes les lumières du salon.
Pour créer une automatisation, direction Paramètres, puis Automatisations et scènes, et le bouton Créer une automatisation. L'éditeur visuel repose sur un triptyque simple à retenir :
- Quand (le déclencheur) : l'événement qui réveille l'automatisation, comme un détecteur de mouvement qui passe à l'état détecté
- Si (les conditions, facultatives) : un filtre de sécurité, par exemple ne continuer que s'il fait nuit
- Alors (les actions) : l'ordre envoyé aux actionneurs, comme allumer la lumière du couloir
En combinant ces trois blocs à la souris, on peut concevoir des scénarios de présence ou de sécurité assez élaborés sans jamais écrire une ligne de code.
Pensez à sauvegarder régulièrement votre configuration, depuis Paramètres, Système, Sauvegardes. Ne laissez jamais vos fichiers de secours sur le même support que le système actif : si le stockage physique lâche, vos sauvegardes disparaissent avec lui. Un add-on comme Home Assistant Google Drive Backup, ou un stockage réseau externe, permet d'externaliser automatiquement chaque nouvelle sauvegarde.
À quel rythme mettre à jour son serveur
L'écosystème Home Assistant évolue à une vitesse rare dans le monde du logiciel. Chaque premier mercredi du mois, Nabu Casa publie une version majeure du Core, identifiée sous la forme Année.Mois. Durant le reste du mois, des correctifs mineurs suivent régulièrement. Cette réactivité impose une discipline simple : n'installez jamais une mise à jour majeure le jour de sa sortie sur votre serveur de production. Laissez les développeurs corriger les premiers bugs et attendez une version corrective (la .2 ou la .3) pour mettre à jour sereinement.
Zha ou zigbee2mqtt : le choix qui change tout
Une fois l'antenne branchée, deux philosophies s'affrontent pour gérer le réseau radio. La solution la plus simple s'appelle ZHA, pour Zigbee Home Automation, une intégration native au cœur du système. Elle fonctionne en trois clics, mais elle enferme la gestion de la radio dans le moteur même de Home Assistant : si le serveur redémarre pour une mise à jour, tout le réseau Zigbee s'effondre et doit se reconstruire péniblement.
J'ai préféré une architecture plus modulaire : le couple Zigbee2MQTT et Mosquitto MQTT. Avec cette méthode, la gestion de la clé USB et le décodage des trames radio sont totalement isolés dans un processus autonome. Les informations sont traduites en texte brut et envoyées vers un serveur de messagerie local, le broker Mosquitto. Home Assistant n'a plus qu'à lire ce flux. Si Home Assistant redémarre, la radio continue de tourner en tâche de fond, ce qui garantit une stabilité et une rapidité bien supérieures, en plus d'un catalogue de périphériques compatibles généralement plus réactif que celui de ZHA.
Installer le broker mqtt
La première brique à poser, c'est le broker MQTT. Avec Home Assistant OS, direction Paramètres, puis Apps, et on cherche l'extension officielle Mosquitto broker. Une fois installée, on vérifie les ports dans l'onglet Configuration (le port 1883 par défaut), on peut laisser les paramètres d'usine, puis on coche Démarrer au lancement et Surveiller avant de cliquer sur Démarrer.
Ajouter zigbee2mqtt
Zigbee2MQTT n'étant pas une extension officielle de Nabu Casa, elle n'apparaît pas nativement dans la boutique. Il faut cliquer sur les trois points en haut à droite du Magasin d'applications, sélectionner Dépôts, et coller l'adresse du dépôt GitHub officiel du projet. Après un rafraîchissement de la page, une nouvelle section communautaire apparaît avec l'add-on Zigbee2MQTT. On l'installe simplement, sans les autres modules annexes (Edge, Praxy) qui ne sont pas nécessaires pour une installation standard.
Configurer la clé usb et le protocole
Avant de démarrer Zigbee2MQTT, il faut lui associer le matériel dans l'onglet Configuration de l'add-on, en mode texte YAML si besoin. Dans la section serial, deux lignes sont indispensables : le chemin persistant de la clé (visible dans l'onglet Informations matérielles de Home Assistant, sous une forme du type /dev/serial/by-id/usb-...), et selon le contrôleur, la ligne adapter avec la valeur ember pour les puces Silicon Labs récentes, qui indique d'utiliser le pilote de communication unifié. Une fois enregistré, on retourne sur l'onglet Informations et on clique sur Démarrer : un nouveau menu Zigbee2MQTT apparaît dans la barre latérale.
Appairage et maillage du réseau
C'est ici qu'on se confronte aux limites physiques de la bande des 2,4 GHz. Contrairement au Z-Wave et ses basses fréquences qui traversent les parois épaisses, le signal 2,4 GHz s'effondre plus facilement face à des murs en pierre traditionnels. Pour stabiliser un réseau dans une maison ancienne, il faut structurer un maillage rigoureux : les modules sur pile (capteurs d'ouverture, boutons) sont des terminaux passifs, ce sont les modules branchés sur secteur qui servent de répéteurs. Positionner quelques prises ou interrupteurs connectés à des endroits stratégiques suffit souvent à couvrir toute une maison.
Pour une pièce isolée par des murs très épais, une astuce simple consiste à recycler un vieux Raspberry Pi en antenne déportée : on y installe une instance autonome de Zigbee2MQTT, configurée pour pointer vers le broker MQTT de votre serveur principal via son adresse IP locale. Cette instance secondaire pousse ses informations sur le réseau Ethernet classique, et Home Assistant centralise la donnée normalement.
Foire aux questions
- Faut-il forcément un abonnement Nabu Casa pour utiliser Home Assistant à distance ?
- Non. Tailscale est une alternative gratuite tout à fait fonctionnelle, qui évite également d'ouvrir des ports sur votre box. L'abonnement Nabu Casa reste toutefois la solution la plus simple pour qui ne veut pas s'occuper de la configuration réseau.
- Pourquoi ma clé Zigbee ne s'appaire avec aucun appareil ?
- Le cas le plus fréquent est une interférence USB : la clé est branchée trop près du châssis de la machine. Utilisez une rallonge d'au moins 50 centimètres pour l'éloigner des sources de bruit électromagnétique.
- ZHA ou Zigbee2MQTT, lequel choisir pour débuter ?
- ZHA est plus rapide à mettre en place et suffit pour une petite installation. Zigbee2MQTT demande un peu plus de configuration au départ, mais offre une meilleure stabilité et un catalogue de périphériques plus large sur la durée.
- Combien de temps prend l'installation de Home Assistant OS ?
- Comptez une dizaine de minutes pour le déploiement du système une fois l'image flashée, et une bonne heure pour configurer les premières intégrations et créer vos premières pièces.
Dans le troisième et dernier article de cette série, je vous montrerai comment j'ai automatisé mon chauffage électrique, sécurisé mes ouvrants et mis en place une vidéosurveillance locale avec des caméras Tapo, sans qu'aucune donnée ne quitte mon réseau.