Guide pratique pour installer HACS sur Home Assistant et booster les fonctionnalités de votre domotique

En bref

• HACS est un catalogue communautaire qui ajoute des intégrations, cartes et thèmes absents du dépôt officiel de Home Assistant.
• Avant toute installation, une sauvegarde complète et un compte GitHub protégé par une double authentification sont recommandés.
• La méthode la plus simple passe par l’add-on officiel Terminal & SSH, puis par l’activation de HACS dans « Appareils et services ».
• Les extensions communautaires sont utiles, mais elles demandent une sélection prudente et des mises à jour suivies.
• Une personnalisation réussie commence par un besoin concret : améliorer un tableau de bord, relier un appareil non pris en charge ou fiabiliser une automatisation.

Pourquoi installer HACS sur Home Assistant pour enrichir sa domotique

HACS, pour Home Assistant Community Store, n’est pas un magasin officiel au sens classique. Il s’agit d’un gestionnaire de contenus développé et entretenu par la communauté. Son rôle est de simplifier l’accès à des projets publiés sur GitHub : intégrations, cartes pour tableaux de bord, thèmes graphiques, automatisations et composants complémentaires.

Home Assistant propose déjà une très grande bibliothèque d’intégrations natives. Pour une grande partie des logements, elle suffit à piloter les éclairages, le chauffage, les capteurs d’ouverture, les détecteurs de fumée connectés ou la consommation électrique. HACS devient pertinent lorsque l’installation domotique rencontre une limite concrète : un appareil n’est pas reconnu, une donnée utile n’est pas affichée clairement ou une carte standard ne permet pas de construire un tableau de bord lisible.

Le principal intérêt est donc la personnalisation. Sans ce catalogue communautaire, ajouter une extension exige souvent de télécharger des fichiers, de créer les bons dossiers, puis de surveiller manuellement les mises à jour. HACS centralise ces opérations. Il ne rend pas la configuration magique, mais il réduit nettement les manipulations répétitives.

Un exemple parlant concerne une famille qui utilise Home Assistant pour suivre son logement secondaire. Les informations essentielles sont simples : température intérieure, humidité, état de l’alarme, fuite d’eau et niveau de batterie des capteurs. Les cartes natives affichent ces données. Une carte installée via HACS peut toutefois les présenter sur une seule vue, avec des seuils visuels clairs. L’objectif n’est pas de créer un écran spectaculaire. Il est de voir en moins de 10 secondes ce qui mérite une action.

La richesse de l’écosystème communautaire a aussi une contrepartie. Chaque ajout est du code supplémentaire. Il peut évoluer, être abandonné ou provoquer une incompatibilité après une mise à jour de Home Assistant. Le dépôt officiel applique ses propres règles de validation. Les projets accessibles via HACS reposent sur des mainteneurs indépendants. Beaucoup sont sérieux et très suivis, mais tous ne présentent pas le même niveau de maintenance.

Cette différence doit guider la décision. Pour une automatisation liée au confort, comme l’allumage progressif d’une lampe au coucher du soleil, une extension communautaire peut être très pertinente. Pour une fonction sensible, par exemple le pilotage d’une serrure connectée ou d’un système d’alarme, il vaut mieux privilégier une intégration officielle, documentée et régulièrement mise à jour. Une solution pratique ne doit jamais devenir un point faible pour le logement.

Ce que HACS apporte réellement au quotidien

HACS classe généralement les ressources en plusieurs familles. Les intégrations connectent de nouveaux services ou équipements. Les cartes permettent d’améliorer l’affichage Lovelace. Les thèmes modifient l’apparence de l’interface. Enfin, certains projets proposent des modèles, des scripts ou des composants qui répondent à des usages très ciblés.

HACS ne remplace donc pas Home Assistant. Il l’élargit. Cette nuance compte. L’outil sert à installer et suivre des contenus externes, pas à administrer les appareils du foyer à la place du système domotique. Après l’installation, la plupart des intégrations restent à configurer dans les menus habituels, avec leurs identifiants, leurs autorisations et leurs paramètres propres.

Une règle simple permet de conserver une installation saine : un besoin identifié, une extension testée, une sauvegarde vérifiée. Cette méthode évite l’accumulation de composants inutilisés. Elle limite aussi les recherches compliquées lorsqu’une mise à jour provoque un comportement inhabituel.

La prochaine étape consiste à préparer le système correctement. Quelques minutes passées sur les prérequis évitent la majorité des erreurs d’installation.

Prérequis HACS Home Assistant : sauvegarde, GitHub et accès au terminal

Avant d’installer HACS, il faut vérifier trois éléments : le type d’installation Home Assistant, l’existence d’une sauvegarde récente et l’accès à un compte GitHub. Ces précautions peuvent sembler secondaires pour une extension gratuite. Elles sont pourtant indispensables dès lors que la domotique pilote des équipements du logement.

Home Assistant existe sous plusieurs formes. Home Assistant OS est la solution la plus accessible pour un Raspberry Pi, un mini-PC ou un appareil dédié. Elle donne accès à une interface de gestion complète et aux modules complémentaires. Home Assistant Supervised propose une logique proche, mais demande un environnement Linux compatible. Avec Home Assistant Container ou Core, l’accès au système se fait autrement, souvent par terminal ou Docker. La procédure générale de HACS reste proche, mais l’emplacement et les droits d’accès peuvent différer.

Dans un logement équipé d’une dizaine de capteurs, la remise en état après une erreur reste assez rapide. Dans une maison avec des dizaines d’entités, des tableaux de bord, des scénarios de chauffage et des notifications de sécurité, elle peut prendre plusieurs heures. Une sauvegarde avant intervention est donc un vrai gain de temps. Dans Home Assistant OS, elle se crée depuis les paramètres système, dans la rubrique des sauvegardes.

Il est conseillé de réaliser une sauvegarde complète, puis de la télécharger sur un ordinateur ou de l’envoyer vers un espace de stockage distinct. Conserver une copie sur le même support que Home Assistant protège peu contre une panne du support de stockage. Une carte microSD peut s’user. Un SSD est plus endurant, mais aucun matériel n’est à l’abri d’un incident.

Créer et sécuriser le compte GitHub nécessaire à HACS

HACS utilise GitHub pour accéder aux dépôts qui hébergent les projets communautaires. Un compte gratuit suffit. Il n’est pas nécessaire de créer un compte dédié si un compte personnel existe déjà. En revanche, il est préférable d’activer la double authentification. Cette mesure protège l’accès au compte, donc aux autorisations accordées à la plateforme domotique.

Lors de l’activation, Home Assistant affiche généralement un code et ouvre une procédure d’autorisation GitHub. Cette méthode évite de saisir son mot de passe GitHub directement dans Home Assistant. Il faut comparer le code affiché et celui présenté par GitHub, puis valider uniquement si les deux correspondent.

Le piège classique consiste à accepter une demande d’autorisation sans lire son origine. Il faut rester sur le parcours déclenché depuis l’interface Home Assistant ou saisir soi-même l’adresse officielle de GitHub dans le navigateur. Un message reçu par courriel ou une fenêtre inattendue ne doit pas servir de point de départ.

Installer Terminal & SSH sans ouvrir inutilement son système

Sur Home Assistant OS, l’add-on officiel Terminal & SSH permet d’exécuter la commande d’installation dans une interface web. Il se trouve habituellement dans Paramètres, Modules complémentaires, Boutique des modules complémentaires. Si cette rubrique n’apparaît pas, le mode avancé peut devoir être activé dans le profil utilisateur.

Après l’installation du module, il faut le démarrer, puis ouvrir son interface web. Le mot SSH peut inquiéter, car il renvoie à un accès distant au système. Utilisé depuis l’interface locale de Home Assistant, il sert surtout ici à lancer une commande ponctuelle. Il n’est pas nécessaire d’exposer ce service sur Internet. Éviter l’ouverture de ports sur la box internet reste une mesure de base.

1. Créer une sauvegarde complète et conserver une copie hors de l’appareil.
2. Mettre Home Assistant à jour vers une version stable.
3. Créer ou vérifier le compte GitHub, puis activer la double authentification.
4. Installer et démarrer l’add-on officiel Terminal & SSH si Home Assistant OS est utilisé.
5. Prévoir 15 à 30 minutes sans modifier d’autres réglages pendant l’opération.

Dans le cas de Marc, propriétaire d’un pavillon et utilisateur d’un mini-PC, cette préparation a évité une mauvaise surprise. Une ancienne carte personnalisée n’était plus compatible après une mise à jour. Grâce à la sauvegarde, il a restauré l’état précédent en quelques minutes et a reporté la mise à niveau de la carte concernée. La prudence n’empêche pas d’avancer. Elle rend les essais réversibles.

Une fois ces bases réunies, l’installation de HACS devient une opération courte et contrôlée, plutôt qu’une succession de manipulations incertaines.

Installer HACS sur Home Assistant avec la méthode Terminal & SSH

L’installation se déroule en deux temps. D’abord, le script officiel copie les fichiers nécessaires dans l’environnement Home Assistant. Ensuite, HACS est ajouté comme intégration depuis l’interface graphique. Cette distinction est importante : voir défiler du texte dans le terminal ne signifie pas que le catalogue est déjà opérationnel.

Depuis l’interface web de Terminal & SSH, la commande généralement fournie par le projet HACS permet de récupérer et d’exécuter le programme d’installation :

wget -O – https://get.hacs.xyz | bash –

Cette commande doit être utilisée uniquement après avoir vérifié l’adresse sur la documentation officielle de HACS. Les scripts distants sont pratiques, mais ils méritent une attention particulière. Une adresse légèrement modifiée peut conduire à télécharger un contenu non fiable. Il est donc préférable de la recopier depuis la source officielle, sans passer par un message de forum ou une vidéo ancienne.

Après validation, plusieurs lignes s’affichent dans le terminal. Elles indiquent le téléchargement, la création des fichiers et la fin du processus. Si un message d’erreur apparaît, il ne faut pas multiplier les commandes au hasard. Le premier contrôle porte sur la connexion internet de Home Assistant, puis sur la commande elle-même : un copier-coller depuis un téléphone peut parfois ajouter un caractère invisible ou modifier un tiret.

Redémarrer Home Assistant avant l’activation de l’intégration

Une fois le script terminé sans erreur, Home Assistant doit être redémarré. Cette étape charge le nouveau composant. Il ne suffit pas de fermer le navigateur ou de redémarrer la tablette qui sert d’écran de contrôle. Le redémarrage se lance depuis les paramètres système de Home Assistant.

Un redémarrage dure souvent entre 1 et 5 minutes selon le matériel et le nombre d’intégrations. Sur un Raspberry Pi utilisant une carte microSD fatiguée, le délai peut être plus long. Patienter évite de croire trop vite à un blocage. Lorsque l’interface redevient accessible, il faut se rendre dans Paramètres, Appareils et services.

Dans cette page, le bouton « Ajouter une intégration » permet de rechercher HACS. Après avoir sélectionné l’élément correspondant, l’assistant présente des conditions à lire puis à confirmer. Il déclenche ensuite la liaison GitHub. Un code de connexion est affiché. Il doit être saisi ou confirmé dans GitHub selon le parcours proposé, avant d’autoriser la connexion.

Cette autorisation relie HACS au compte GitHub. Elle permet notamment d’accéder aux dépôts communautaires et de respecter les limites d’accès imposées par GitHub. Un utilisateur n’a pas besoin de créer de clé API manuelle pour suivre la procédure standard. L’autorisation par code affichée dans l’interface est plus simple et limite les erreurs.

Vérifier que le catalogue HACS est correctement chargé

Après l’activation, le menu HACS peut ne pas s’afficher immédiatement. Il est raisonnable d’attendre quelques minutes. Le système récupère les informations nécessaires et construit son catalogue. Si le menu reste absent après ce délai, un rechargement complet de la page peut suffire. Vider le cache du navigateur, fermer puis rouvrir l’onglet est parfois utile, surtout sur une tablette utilisée depuis longtemps.

Une vérification simple consiste à ouvrir HACS et à consulter les catégories disponibles. Si les listes d’intégrations et d’interfaces s’affichent, l’installation est terminée. Aucun achat, abonnement ou service de télésurveillance n’est nécessaire pour utiliser HACS. Le coût réel se situe ailleurs : le temps consacré au choix, aux tests et aux mises à jour.

À retenir : HACS ne doit jamais être installé dans la précipitation sur une plateforme non sauvegardée. La procédure technique est courte. La préparation et le contrôle des sources font la différence entre une amélioration utile et une panne évitable.

Le catalogue est désormais disponible. Reste à choisir les premiers ajouts avec méthode, car l’abondance d’options peut rapidement nuire à la lisibilité de la domotique.

Configurer HACS et choisir des extensions utiles sans fragiliser Home Assistant

Une fois HACS actif, la tentation est grande d’installer plusieurs dizaines de cartes et d’intégrations en une soirée. C’est rarement la bonne approche. Chaque extension augmente le nombre de dépendances, de réglages et de mises à jour à surveiller. Une configuration robuste commence par une question très simple : quel problème concret cette extension résout-elle ?

Pour une maison familiale, trois besoins reviennent souvent. Le premier est la lisibilité : réunir les informations utiles sur un tableau de bord. Le deuxième est la compatibilité : faire remonter les données d’un appareil absent des intégrations natives. Le troisième est l’automatisation : rendre un scénario plus fiable ou plus fin, par exemple différencier une présence réelle d’un simple passage dans un couloir.

Lorsqu’une extension est trouvée dans HACS, plusieurs éléments doivent être examinés avant de l’installer. La documentation doit être accessible. Le dépôt doit indiquer les versions compatibles. Les mises à jour récentes sont un signal favorable, sans être une garantie absolue. Les problèmes connus, les demandes d’aide et les réponses du mainteneur donnent aussi une idée de la maturité du projet.

Une méthode de sélection en quatre contrôles

• Vérifier l’usage : l’extension répond-elle à un besoin réel ou seulement à une envie de modifier l’écran ?
• Lire la documentation : une procédure claire indique les permissions, les paramètres et les limites du composant.
• Contrôler l’activité : une mise à jour récente et des échanges suivis réduisent le risque d’abandon, sans l’éliminer.
• Tester progressivement : installer un seul ajout, redémarrer si nécessaire, puis vérifier les journaux avant d’en ajouter un autre.

Cette méthode est particulièrement utile pour les équipements liés à la sécurité domestique. Un détecteur d’ouverture ou une caméra peuvent être affichés dans Home Assistant. Cela ne transforme pas le tableau de bord en système certifié de protection. En France, les certifications telles que NF&A2P concernent des matériels et des configurations de sécurité précis. Une automatisation personnelle, aussi soignée soit-elle, ne bénéficie pas automatiquement de cette reconnaissance.

Le même principe vaut pour les caméras. Une intégration HACS peut améliorer l’affichage de flux vidéo ou ajouter des fonctions de détection. Elle ne modifie pas les règles applicables. Une caméra installée par un particulier doit respecter la vie privée : elle ne doit pas filmer la voie publique, ni la propriété voisine. Le RGPD s’applique notamment lorsque des images permettent d’identifier des personnes dans un cadre organisé ou professionnel. Dans tous les cas, limiter le champ de vision reste une précaution essentielle.

Installer, redémarrer, puis configurer sans confondre les étapes

Dans HACS, l’installation d’une extension télécharge ses fichiers. Selon le projet, un redémarrage de Home Assistant peut être nécessaire. Ensuite seulement, l’intégration apparaît dans « Appareils et services » ou la carte devient sélectionnable dans l’éditeur de tableau de bord. Ce décalage est fréquent et ne traduit pas un échec.

Prenons l’exemple d’une carte destinée à afficher la consommation électrique. Après installation, elle peut exiger l’ajout d’une ressource dans le tableau de bord, puis la sélection des capteurs de puissance et d’énergie. Installer la carte sans lire son guide aboutit souvent à un encadré vide. Ce n’est pas un défaut de HACS : c’est la phase de configuration propre au projet.

Les mises à jour doivent être traitées avec le même calme. Avant une période d’absence ou avant un déplacement professionnel, mieux vaut éviter de mettre à jour l’ensemble de la domotique. Une mise à jour peut imposer de modifier une carte ou une automatisation. Il est plus prudent de les planifier quand un contrôle de l’installation est possible.

Un bon tableau de bord n’est pas celui qui contient le plus de widgets. C’est celui qui montre la bonne information, au bon moment, sans masquer une alerte utile sous une accumulation de détails.

Personnalisation Home Assistant : créer un tableau de bord clair et des automatisations maîtrisées

HACS est souvent installé pour améliorer l’apparence de Home Assistant. Cet objectif est légitime, à condition que le design serve l’usage quotidien. Un écran de domotique doit d’abord aider à prendre une décision. La température trop basse, une fenêtre restée ouverte ou une fuite détectée doivent apparaître clairement. Les effets visuels viennent après.

La personnalisation peut commencer par une séparation simple en zones : sécurité, confort, énergie et extérieur. Dans un appartement, une page unique suffit souvent. Dans une maison à étage, une vue par niveau évite de faire défiler une liste interminable. Pour une résidence secondaire, une vue « contrôle à distance » est généralement plus utile qu’un plan complet des pièces.

Claire, par exemple, utilise une tablette murale dans l’entrée et une application mobile hors de chez elle. Sur la tablette, elle veut voir les lumières, le chauffage et les ouvertures. Sur téléphone, elle consulte plutôt les notifications, la température et les images de la caméra d’accès. Deux interfaces différentes répondent à deux contextes différents. HACS permet d’affiner cette présentation, mais le besoin doit rester le point de départ.

Concevoir une automatisation qui reste compréhensible

Une automatisation fiable repose sur trois éléments : un déclencheur, des conditions et une action. Le déclencheur est l’événement de départ, comme l’ouverture d’une porte. Les conditions évitent les réactions inadaptées, par exemple ne pas allumer toutes les lumières en plein jour. L’action est le résultat : éclairage, notification ou arrêt du chauffage.

Une extension communautaire peut enrichir ces scénarios. Elle peut fournir un capteur plus précis, une carte de contrôle plus lisible ou une capacité non disponible par défaut. Pour autant, elle ne doit pas rendre le fonctionnement incompréhensible. Si personne dans le foyer ne sait expliquer pourquoi un chauffage s’éteint, l’automatisation devra tôt ou tard être simplifiée.

Une approche efficace consiste à nommer chaque scénario de manière explicite. « Éteindre chauffage si fenêtre salon ouverte 10 min » est plus clair que « Mode éco 2 ». Ajouter une notification temporaire lors des premiers jours de test aide à vérifier le comportement réel. Après validation, elle peut être supprimée pour éviter les alertes inutiles.

Garder une domotique sûre, lisible et maintenable

La sécurité numérique fait partie de l’entretien courant. Home Assistant, HACS et les extensions doivent être mis à jour, mais pas aveuglément. Lire les notes de version permet de repérer les changements importants. Une sauvegarde juste avant une mise à jour majeure offre une solution de retour arrière si une incompatibilité apparaît.

Il est aussi conseillé de limiter les accès. Un mot de passe unique et robuste, la double authentification lorsque disponible, ainsi qu’un accès distant sécurisé sont des bases solides. Exposer directement l’interface Home Assistant sur Internet sans protection adaptée est une mauvaise idée. Un accès distant doit être configuré avec une méthode documentée et maintenue, pas avec une règle improvisée sur le routeur.

Enfin, HACS ne doit pas devenir le cœur invisible de toutes les fonctions du foyer. Les commandes essentielles doivent garder un fonctionnement simple. Un interrupteur doit continuer à allumer une lumière. Un chauffage doit rester utilisable manuellement. Les notifications domotiques sont pratiques, mais elles ne remplacent ni un détecteur de fumée autonome conforme aux exigences applicables, ni les gestes de prévention du quotidien.

Le bon réflexe : avant d’installer la première extension HACS, créer une sauvegarde complète, choisir un seul besoin prioritaire et noter le comportement attendu. Cette discipline de 10 minutes rend la personnalisation plus utile et beaucoup plus sereine.

HACS est-il obligatoire pour utiliser Home Assistant ?

Non. Home Assistant fonctionne très bien sans HACS grâce à ses intégrations officielles. HACS devient utile pour accéder à des contenus créés par la communauté, notamment des cartes, thèmes et intégrations non natives.

Faut-il payer pour installer HACS ?

Non. HACS est un projet communautaire gratuit. Certaines extensions peuvent toutefois nécessiter un compte ou un abonnement chez le service qu’elles relient.

Pourquoi HACS demande-t-il un compte GitHub ?

GitHub héberge les dépôts de nombreux projets communautaires. Le compte permet à HACS d’accéder à ces ressources avec une autorisation contrôlée, généralement par code de connexion.

Que faire si le menu HACS n’apparaît pas après l’installation ?

Redémarrer Home Assistant, attendre quelques minutes, puis actualiser complètement le navigateur. Si le problème persiste, vérifier les journaux, la commande d’installation et la compatibilité de la version utilisée.

Les extensions HACS sont-elles aussi sûres que les intégrations officielles ?

Elles peuvent être très bien maintenues, mais elles ne suivent pas toutes le même processus de validation que les intégrations officielles. Il faut lire la documentation, vérifier l’activité du projet et éviter les extensions inutiles pour les fonctions sensibles.