Home Assistant est installé et accessible depuis votre navigateur — c’est une bonne nouvelle. Maintenant, la vraie question : par où commencer ? Cette page vous guide à travers les premières étapes essentielles, dans l’ordre logique.
Certaines fonctionnalités varient selon la version que vous avez installée. Un indicateur de compatibilité apparaît en début de chaque section pour vous orienter rapidement.
Légende de compatibilité :
✅ Disponible nativement ⚠️ Possible mais manuel / plus complexe ❌ Non disponible
Les mises à jour
✅ HAOS ✅ Supervised ⚠️ Container ⚠️ Core
Home Assistant sort une mise à jour chaque mois, généralement le premier mercredi. Ces mises à jour apportent de nouvelles intégrations, des corrections de bugs et des améliorations de l’interface. Il est conseillé de rester à jour — les intégrations tierces peuvent se casser sur des versions trop anciennes.
HAOS et Supervised — Mise à jour en un clic
Dans Paramètres → Système → Mises à jour, Home Assistant vous avertit quand une nouvelle version est disponible. Un bouton « Mettre à jour » suffit. La mise à jour se fait en quelques minutes, avec un redémarrage automatique. Vos données et configuration sont préservées.
💡 Avant chaque mise à jour majeure (ex: 2025.1 → 2025.2), prenez l’habitude de créer une sauvegarde manuelle — on n’est jamais à l’abri d’un problème de compatibilité avec une intégration personnalisée.
Container et Core — Mise à jour manuelle
Pas de notification automatique. Vous devez surveiller vous-même les nouvelles versions sur home-assistant.io et déclencher la mise à jour manuellement via Docker Compose ou pip selon votre installation. La procédure est décrite dans la page d’installation correspondante.
Les sauvegardes
✅ HAOS ✅ Supervised ⚠️ Container ❌ Core
C’est probablement la première chose à configurer avant même d’ajouter des appareils. Une sauvegarde régulière vous sauvera la mise le jour où quelque chose tourne mal — disque défaillant, fausse manipulation, mise à jour ratée.
HAOS et Supervised — Sauvegardes intégrées
Allez dans Paramètres → Système → Sauvegardes. Vous pouvez créer une sauvegarde manuelle en un clic, ou configurer des sauvegardes automatiques. La sauvegarde inclut toute votre configuration : automations, tableaux de bord, intégrations, add-ons.
Pour les sauvegardes automatiques, installez l’add-on
Pour les sauvegardes automatiques, installez l’add-on « Auto Backup » depuis le store — il permet de programmer des sauvegardes quotidiennes ou hebdomadaires et de les envoyer automatiquement vers un NAS, Google Drive, ou un dossier réseau.
Container — Sauvegarde manuelle du dossier config
Il n’y a pas de système de sauvegarde intégré. Votre configuration est entièrement dans le dossier /config monté sur votre machine hôte. Sauvegardez ce dossier régulièrement avec un script cron, rsync, ou l’outil de sauvegarde de votre choix.
Ajouter une intégration
✅ HAOS ✅ Supervised ✅ Container ✅ Core
Une intégration, c’est le connecteur entre Home Assistant et un appareil ou un service. Ampoules Philips Hue, prises TP-Link, thermostat Nest, météo, Spotify — tout passe par une intégration.
- Allez dans Paramètres → Appareils et services
- Cliquez sur « + Ajouter une intégration » en bas à droite
- Tapez le nom de votre appareil ou service dans la barre de recherche
- Suivez l’assistant de configuration — HA détecte souvent automatiquement les appareils déjà présents sur le réseau
💡 Home Assistant propose souvent des intégrations détectées automatiquement sur votre réseau local (via mDNS, SSDP, Bluetooth…). Vérifiez la section « Découverts » en haut de la page Appareils et services — vos appareils y sont peut-être déjà listés en attente de configuration.
HACS — Le store communautaire
✅ HAOS ✅ Supervised ✅ Container ⚠️ Core
HACS — Home Assistant Community Store — c’est le store non officiel qui donne accès à des milliers d’intégrations, de thèmes et de cartes de tableau de bord créés par la communauté. Ce que vous ne trouvez pas dans le store officiel, vous le trouverez probablement dans HACS.
Installation de HACS
⚠️ HACS nécessite un compte GitHub pour l’installation. C’est gratuit et prend 2 minutes si vous n’en avez pas encore.
- Dans HA, allez dans Paramètres → Add-ons (HAOS/Supervised) ou accédez au terminal de votre machine hôte (Container)
- Ouvrez un terminal et exécutez la commande d’installation officielle disponible sur hacs.xyz
- Redémarrez Home Assistant
- Dans Paramètres → Appareils et services, ajoutez l’intégration HACS et connectez votre compte GitHub
- HACS apparaît dans le menu latéral — vous pouvez maintenant parcourir le catalogue
💡 Sur Container, HACS fonctionne mais l’installation se fait directement sur le système de fichiers. La procédure est un peu différente — référez-vous à la documentation officielle sur hacs.xyz.
Le tableau de bord (Dashboard)
✅ HAOS ✅ Supervised ✅ Container ✅ Core
Le tableau de bord Lovelace, c’est l’interface que vous voyez en arrivant sur Home Assistant. Par défaut, il se génère automatiquement en fonction de vos appareils — mais vous pouvez le personnaliser entièrement.
Passer en mode édition manuelle
- Sur votre tableau de bord, cliquez sur les trois points en haut à droite
- Cliquez sur « Modifier le tableau de bord »
- Désactivez « Contrôle automatique » pour prendre la main et organiser vos cartes librement
Les types de cartes essentielles
- Entité — affiche l’état d’un appareil (lampe allumée/éteinte, température…)
- Bouton — déclenche une action en un clic
- Historique — courbe d’évolution d’un capteur dans le temps
- Lovelace Gauge — jauge pour visualiser une valeur (batterie, humidité…)
- Markdown — bloc de texte libre, utile pour les titres et les notes
💡 Avec HACS installé, vous accédez à des cartes communautaires bien plus évoluées — comme Mini Graph Card pour des graphiques propres, ou Mushroom Cards pour une interface épurée et moderne.
Première automatisation
✅ HAOS ✅ Supervised ✅ Container ✅ Core
Une automatisation, c’est simple : un déclencheur + une ou plusieurs actions. « Si le soleil se couche → allumer la lumière du salon ». « Si je rentre à la maison → désactiver l’alarme et monter le chauffage ».
Créer une automatisation depuis l’interface
- Allez dans Paramètres → Automatisations et scènes
- Cliquez sur « + Créer une automatisation » → « Créer une nouvelle automatisation »
- Définissez le déclencheur : heure, état d’un appareil, position du soleil, présence…
- Ajoutez une condition si besoin : « seulement si personne n’est à la maison » par exemple
- Définissez l’action : allumer une lumière, envoyer une notification, appeler un script…
- Cliquez sur « Enregistrer » et testez votre automatisation
💡 L’éditeur visuel est très bien fait pour débuter. Quand vous serez plus à l’aise, vous pouvez basculer en mode YAML pour plus de contrôle et de flexibilité — c’est le même résultat, juste une autre façon de l’écrire.
Le store d’add-ons
✅ HAOS ✅ Supervised ❌ Container ❌ Core
C’est l’un des grands avantages de HAOS et Supervised : un store d’add-ons intégré qui permet d’installer des services complémentaires en quelques clics, sans toucher à Docker ou à la ligne de commande.
Allez dans Paramètres → Add-ons → Store des add-ons. Vous y trouverez Mosquitto (broker MQTT), Zigbee2MQTT, Node-RED, File Editor, Studio Code Server et bien d’autres. Chaque add-on s’installe, se configure et se met à jour depuis l’interface HA.
⚠️ Sur Container et Core, les add-ons ne sont pas disponibles. Chaque service (Mosquitto, Zigbee2MQTT, Node-RED…) doit être déployé séparément en tant que conteneur Docker indépendant. C’est faisable, mais nettement plus de boulot à la mise en place.
💡 Les add-ons les plus utiles à installer en priorité sont détaillés dans la page suivante — Modules complémentaires.
Accéder aux fichiers de configuration
✅ HAOS ✅ Supervised ⚠️ Container ✅ Core
La configuration avancée de Home Assistant se fait via des fichiers YAML — configuration.yaml, automations.yaml, scripts.yaml… Ces fichiers se trouvent dans le dossier /config de votre installation.
HAOS et Supervised — File Editor ou Studio Code Server
Installez l’add-on File Editor (simple, idéal pour débuter) ou Studio Code Server (VS Code dans le navigateur, pour les plus à l’aise) depuis le store d’add-ons. Vous éditez vos fichiers YAML directement depuis l’interface HA, sans sortir du navigateur.
Container — Accès direct au dossier monté
Votre dossier /config est monté directement sur votre machine hôte — éditez les fichiers avec l’éditeur de votre choix (VS Code, nano, vim…). Les modifications sont prises en compte après un redémarrage de HA ou via Outils développeur → Vérifier la configuration.