Débuter avec Home Assistant en 2026 : guide complet pas à pas

Installer Home Assistant est devenu beaucoup plus simple, mais une fois la première page affichée, une question revient vite : par quoi commencer pour obtenir une maison connectée qui fonctionne vraiment ? Entre le choix du matériel, les intégrations, Zigbee et les automatisations, on peut facilement passer une soirée à tout configurer sans rien automatiser d’utile.

Pour cette nouvelle version du guide, je pars donc d’un objectif précis : faire fonctionner un premier éclairage automatique dans un couloir, puis apprendre à sauvegarder et à entretenir l’installation. Je montre les menus, le code de l’automatisation et les erreurs fréquentes. C’est un scénario pédagogique reproductible, pas le récit d’un test physique effectué chez moi.

1. Quel matériel choisir pour débuter avec Home Assistant ?

Ma règle pour un débutant est simple : privilégier une machine dédiée et Home Assistant OS. C’est généralement plus facile à dépanner qu’un serveur Linux sur lequel tournent déjà dix services. Voici les options les plus pertinentes :

Mon choix pour un premier système : Green si vous partez de zéro et souhaitez réduire les manipulations ; Raspberry Pi si vous possédez déjà le matériel ; mini-PC dédié si vous prévoyez de nombreuses intégrations et un historique conséquent. La documentation officielle détaille les méthodes d’installation actuelles.

Pour la version Raspberry Pi 5, nous avons aussi un tutoriel dédié avec SSD.

2. Installer Home Assistant OS : le chemin le plus simple

Sur un Home Assistant Green, le système est déjà présent. Le démarrage se fait en branchant d’abord l’Ethernet au routeur, puis l’alimentation. Sur un Raspberry Pi ou un mini-PC, vous devez installer l’image Home Assistant OS correspondant au matériel avant de passer à l’écran de bienvenue.

1. Préparer la machine. Green : branchez Ethernet et alimentation. Raspberry Pi ou PC : suivez l’image et la procédure officielles adaptées à votre support, puis connectez le réseau.
2. Ouvrir l’interface. Depuis un ordinateur ou un téléphone sur le même réseau, essayez http://homeassistant.local/, puis http://homeassistant.local:8123/ si nécessaire.
3. Créer ou restaurer une installation. Choisissez le nouveau compte administrateur, un mot de passe unique, et configurez le nom de la maison.
4. Renseigner votre localisation. Vérifiez pays, fuseau horaire, unité de température et emplacement : ces réglages affectent notamment les automatisations basées sur le soleil.
5. Contrôler les intégrations détectées. Dans Paramètres → Appareils et services, examinez les découvertes et n’ajoutez que les équipements utiles pour commencer.

Si le nom homeassistant.local n’est pas résolu par votre réseau, essayez l’adresse IP locale de la machine suivie de :8123. Cette étape est décrite dans le guide de démarrage officiel.

3. Appareils, entités et pièces : les trois notions à comprendre

Pour que l’installation reste lisible, je distingue toujours l’appareil (un module physique), ses entités (température, mouvement, lumière…) et sa pièce (salon, entrée, couloir). Un même appareil peut exposer plusieurs entités ; une automatisation cible souvent une entité précise.

Pour notre couloir, imaginons un détecteur de mouvement et une lampe. Home Assistant peut leur attribuer des identifiants comme binary_sensor.couloir_mouvement et light.couloir. Ce sont des exemples : vous devez récupérer les vrais identifiants de votre installation dans Outils de développement → États.

Donnez des noms explicites dès le départ. Dans six mois, capteur_1 ne vous dira plus rien, alors que « Couloir – Mouvement » sera toujours compréhensible.

4. Ajouter un premier capteur Zigbee : ce qu’il faut réellement acheter

Le Wi-Fi n’est pas obligatoire pour tous vos objets connectés. Zigbee permet de relier de nombreux capteurs sur batterie et de créer un réseau maillé. Mais il faut distinguer le serveur Home Assistant et le coordinateur Zigbee : ce dernier sert de passerelle radio vers les périphériques.

Point souvent oublié : Home Assistant Green n’a pas de radio Zigbee intégrée. Il faut donc lui ajouter un adaptateur compatible, comme le Home Assistant Connect ZBT-2 pour une nouvelle installation Zigbee, ou un matériel équivalent pris en charge. Vérifier les coordinateurs compatibles dans la documentation ZHA.

Pour commencer, je privilégierais ZHA, directement intégré à Home Assistant, puis j’associerais un seul détecteur de mouvement. Zigbee2MQTT constitue une excellente option lorsqu’on souhaite davantage de contrôle sur le matériel et le réseau, mais ajoute des composants à maintenir. Notre comparatif ZHA / Zigbee2MQTT explique le choix.

Appairage conseillé : installer le coordinateur, ouvrir l’intégration Zigbee, lancer l’ajout d’appareil, mettre le détecteur en mode appairage et le renommer. Si vous utilisez un coordinateur USB, l’éloigner du port USB 3.0 et d’autres sources d’interférences avec une rallonge adaptée peut améliorer la réception.

5. Mon exemple concret : éclairer le couloir seulement la nuit

Voici un petit scénario qui rend Home Assistant immédiatement utile. L’objectif est clair : allumer la lampe lors d’un mouvement pendant la nuit, puis l’éteindre après trois minutes sans détection. Pas besoin de créer dix scènes avant de voir le résultat.

Sans code : la version avec l’éditeur visuel

1. Allez dans Paramètres → Automatisations et scènes, puis créez une nouvelle automatisation.
2. Ajoutez un déclencheur quand le détecteur de couloir passe à « mouvement détecté ».
3. Ajoutez une condition « soleil couché » pour n’allumer la lampe que la nuit.
4. Ajoutez l’action « allumer la lumière du couloir ».
5. Pour l’extinction, créez un second déclencheur « absence de mouvement pendant 3 minutes » et sa branche d’extinction, ou une seconde automatisation. Donnez un nom clair à l’ensemble.

Le YAML ci-dessous reprend les deux cas dans une seule automatisation en utilisant les identifiants de déclencheurs. La syntaxe a été vérifiée par analyse YAML et contrôles de structure. Son exécution sur une vraie instance Home Assistant n’a pas été testée dans le cadre de cet article.

alias: "Couloir : éclairage automatique la nuit"
description: "Allumage au mouvement, extinction après 3 min sans détection"
triggers:
  - trigger: state
    entity_id: binary_sensor.couloir_mouvement
    to: "on"
    id: mouvement
  - trigger: state
    entity_id: binary_sensor.couloir_mouvement
    to: "off"
    for: "00:03:00"
    id: absence
actions:
  - choose:
      - conditions:
          - condition: trigger
            id: mouvement
          - condition: sun
            after: sunset
            before: sunrise
        sequence:
          - action: light.turn_on
            target:
              entity_id: light.couloir
      - conditions:
          - condition: trigger
            id: absence
        sequence:
          - action: light.turn_off
            target:
              entity_id: light.couloir
mode: restart

Copiez ce contenu dans l’éditeur YAML d’une automatisation individuelle, après avoir remplacé les deux identifiants entity_id. Si vous modifiez directement automations.yaml, respectez son format de liste d’automatisations : cet exemple y devient un élément précédé de - et avec un id unique pour rester éditable depuis l’interface.

6. Vérifier que cela fonctionne et comprendre les échecs

Avant de multiplier les automatisations, je regarderais les traces. Dans Paramètres → Automatisations et scènes, ouvrez l’automatisation puis ses traces d’exécution. Elles montrent quel déclencheur est intervenu, quelles conditions sont passées ou ont échoué et quelles actions ont été appelées. Documentation officielle des tests et traces.

Un point subtil : le bouton d’exécution manuelle d’une automatisation ne reproduit pas forcément son déclencheur réel. Pour tester ce scénario, provoquez un changement d’état du détecteur et contrôlez la trace correspondante.

7. Un premier tableau de bord, sans empiler 50 cartes

Je préfère un tableau de bord qui répond d’abord à deux questions : « Est-ce que la lampe est allumée ? » et « Est-ce qu’un mouvement est détecté ? ». Une carte d’entités suffit. Dans un tableau de bord modifiable, ajoutez une carte Entités en mode YAML :

type: entities
title: Ma maison
show_header_toggle: false
entities:
  - entity: light.couloir
    name: Couloir
  - entity: binary_sensor.couloir_mouvement
    name: Mouvement dans le couloir

Avec vos vrais identifiants, vous obtenez une vue lisible depuis un téléphone ou une tablette. Ajoutez ensuite la température de la pièce ou l’état d’ouverture d’une porte si cela vous sert au quotidien. Notre article sur la transformation d’une tablette en écran Home Assistant va plus loin sur l’affichage mural.

8. Les sauvegardes et la sécurité, avant les gros projets

Une installation domotique est un petit serveur, pas une simple application. Je conseille de préparer une sauvegarde avant de multiplier les équipements. Dans Paramètres → Système → Sauvegardes, activez les sauvegardes automatiques, téléchargez et conservez le kit de récupération / la clé de chiffrement, puis configurez idéalement une destination en dehors du serveur. Procédure officielle des sauvegardes.

Conservez au moins une copie externe : une sauvegarde stockée uniquement sur le disque qui tombe en panne ne vous sauvera pas. Et avant une grosse mise à jour, effectuez une sauvegarde manuelle. Une sauvegarde chiffrée sans sa clé de récupération peut devenir inutilisable.

Sur la partie sécurité, choisissez un mot de passe administrateur unique, activez la double authentification depuis votre profil utilisateur (rubrique Sécurité) et maintenez le système à jour. Pour accéder à la maison depuis l’extérieur, privilégiez Home Assistant Cloud ou un VPN correctement configuré, plutôt qu’une ouverture directe du port 8123 sur la box.

9. Et après ? Un parcours pour progresser sans se disperser

Une fois votre éclairage de couloir opérationnel, je suivrais cet ordre : ajouter une pièce, puis un capteur de température, ensuite une prise avec mesure d’énergie et enfin un tableau de bord adapté aux usages de la famille. Les scénarios complexes de chauffage et de sécurité viennent après, lorsque les capteurs et les sauvegardes sont fiables.

Pour aller plus loin : créer son propre capteur ESPHome avec un ESP32, construire son réseau Zigbee ou parcourir notre dossier Home Assistant.

Questions fréquentes

Home Assistant est-il gratuit ?

Le logiciel Home Assistant est open source et peut être utilisé sans abonnement. Le matériel et certains services complémentaires, comme Home Assistant Cloud, peuvent être payants.

Faut-il savoir programmer ou utiliser YAML ?

Non, on peut démarrer avec les assistants de configuration et l’éditeur visuel. Le code YAML de ce guide est un exemple pour comprendre et partager précisément une automatisation.

Peut-on utiliser Home Assistant sans Internet ?

De nombreuses commandes locales et automatisations fonctionnent sans connexion Internet si vos équipements et intégrations le permettent. Les assistants vocaux et services d’un fabricant qui dépendent de son cloud peuvent toutefois cesser de fonctionner hors ligne.

Zigbee est-il obligatoire ?

Non. Home Assistant sait utiliser des appareils Wi-Fi, Ethernet, Matter et d’autres protocoles. Zigbee est une possibilité intéressante pour les capteurs peu gourmands en énergie, mais nécessite un coordinateur compatible.

Que se passe-t-il si mon serveur tombe en panne ?

Les automatismes hébergés sur Home Assistant s’arrêtent tant que le serveur est indisponible. Certains périphériques continuent de fonctionner localement selon leurs propres capacités. Une sauvegarde externe et un matériel fiable facilitent la remise en route.

Sources principales : installation officielle · premier démarrage · éditeur d’automatisations · Zigbee/ZHA · sauvegardes.