Étendre Home Assistant : intégrations, Apps et Marketplace

Un forum vous dit « installez l'add-on », un autre « passez par HACS », un troisième « ajoutez l'intégration ». Les trois parlent d'étendre Home Assistant, mais ce ne sont pas du tout les mêmes objets : ils ne s'installent pas au même endroit, ne tournent pas au même endroit, et surtout ne viennent pas des mêmes personnes. Les confondre est la première source de pannes, et parfois d'un risque qu'on n'a pas vu passer.

Ce guide pose les trois familles, montre comment installer chacune, et donne une grille simple pour décider si une extension de la communauté mérite une place chez vous.

Il suppose une installation qui fonctionne. Si ce n'est pas le cas, commencez par Premiers pas avec Home Assistant.

Version visée : Home Assistant 2026.11, dont la sortie stable est annoncée pour le 4 novembre 2026. Deux noms ont changé récemment : les modules complémentaires (« add-ons ») s'appellent Apps depuis la version 2026.2, et HACS devient le Marketplace, intégré à Home Assistant, à partir de 2026.11. Ce guide utilise les nouveaux noms et rappelle les anciens. Si vous êtes encore sur une version antérieure, faites d'abord la mise à jour (après une sauvegarde) plutôt que d'installer HACS : il ne s'installe plus à partir de 2026.11. Les écrans sont décrits par leur fonction ; les noms entre guillemets sont ceux de l'interface anglaise, vérifiés sur la documentation officielle en octobre 2026.

Les trois familles, en une image

La comparaison la plus juste est celle du téléphone :

• une intégration, c'est le compte que vous reliez dans un réglage : elle connecte Home Assistant à un appareil ou à un service (votre box, vos ampoules, la météo) ;
• une App, c'est une application à part entière qui tourne à côté de Home Assistant, sur la même machine : un éditeur de fichiers, un serveur de messages ;
• une extension du Marketplace, c'est un logiciel écrit par un particulier, installé hors du catalogue officiel : une intégration, une carte de tableau de bord ou un thème que le projet Home Assistant n'a ni écrit, ni testé, ni audité.

Le projet le résume ainsi : les Apps tournent à côté de Home Assistant, les intégrations connectent Home Assistant à vos appareils.

flowchart TD
    HA["Home Assistant"]
    subgraph OFF["Catalogue officiel"]
        I["Intégrations<br/>connectent HA aux appareils et services<br/>tous les modes d'installation"]
        A["Apps (ex-modules complémentaires)<br/>logiciels qui tournent à côté de HA<br/>Home Assistant OS seulement"]
    end
    subgraph COM["Communauté : non testé, non audité"]
        M["Marketplace (ex-HACS)<br/>intégrations, cartes, thèmes, modèles<br/>écrits par des tiers"]
    end
    I -->|"code chargé dans HA"| HA
    A -->|"conteneur séparé, même machine"| HA
    M -->|"code chargé dans HA<br/>ou dans le navigateur"| HA
    A -.->|"ex. Mosquitto"| I

La flèche pointillée n'est pas un détail : souvent, une App et une intégration vont ensemble. L'App Mosquitto fait tourner un serveur MQTT ; l'intégration MQTT permet à Home Assistant de lui parler. Installer l'une sans l'autre ne donne rien.

Ce que votre mode d'installation permet

Le choix fait au moment de l'installation, décrit dans Premiers pas avec Home Assistant, décide de ce qui vous est ouvert :

En conteneur, il n'y a pas de rubrique Apps. Le logiciel qu'une App aurait installé pour vous (un serveur MQTT, par exemple) se fait tourner dans un autre conteneur, à côté, et c'est à vous de le mettre à jour et de le sauvegarder. Ce n'est pas un défaut, c'est le prix de la souplesse.

Avant chaque ajout : une sauvegarde

Toute extension modifie l'installation. La règle tient en une ligne : sauvegarde d'abord, ajout ensuite. Depuis la rubrique Sauvegardes des paramètres, lancez une sauvegarde manuelle et attendez qu'elle soit terminée. Si l'ajout casse quelque chose, vous revenez en arrière en dix minutes au lieu d'une soirée. Le cours Home Assistant au quotidien détaille le réglage des sauvegardes automatiques.

Installer une intégration officielle

C'est le cas le plus courant, et le plus sûr : le code est relu par le projet et livré avec Home Assistant.

1. Ouvrez Paramètres, puis la rubrique des appareils et services.
2. Utilisez le bouton d'ajout d'une intégration et tapez le nom de la marque ou du service.
3. Suivez l'assistant : selon les cas, il demande l'adresse de l'appareil, un identifiant, ou vous fait appuyer sur un bouton physique.
4. Rattachez les appareils créés à leur pièce.

Beaucoup d'appareils sont même découverts tout seuls sur le réseau : une notification vous propose alors de les configurer. Avant de chercher plus loin, regardez toujours si la marque figure dans la liste officielle : c'est la seule voie qui sera encore maintenue dans deux ans.

Installer une App (Home Assistant OS)

Prenons Mosquitto, le serveur MQTT dont ont besoin Zigbee2MQTT et beaucoup d'appareils fabriqués maison.

1. Ouvrez Paramètres, puis Apps (anciennement « Modules complémentaires » ou « Add-ons »).
2. Ouvrez la boutique d'Apps (« Install app »). Elle liste les Apps officielles ; des dépôts de la communauté peuvent y être ajoutés, mais ce guide s'en tient aux officielles.
3. Choisissez Mosquitto broker, puis installez-la.
4. Avant de la démarrer, lisez l'onglet de documentation de l'App : c'est là que se trouvent les réglages à faire. Activez ensuite le démarrage automatique, pour qu'elle redémarre avec la machine.
5. Démarrez-la, puis consultez son journal : il doit se terminer sans erreur.
6. Retournez dans les appareils et services : Home Assistant propose généralement d'ajouter l'intégration MQTT qui lui parle. Acceptez.

Chaque App consomme de l'espace disque, de la mémoire et du processeur. La documentation officielle le dit sans détour : n'installez que ce dont vous avez besoin. Sur un Raspberry Pi, cinq Apps « pour voir » suffisent à ralentir toute la maison.

Le Marketplace (ex-HACS) : ce que c'est vraiment

Pendant des années, HACS (Home Assistant Community Store) était lui-même une extension non officielle, qu'on installait à la main pour accéder au travail de la communauté. À partir de 2026.11, il devient le Marketplace, intégré à Home Assistant, dans les paramètres. Concrètement :

• vous le trouvez dans Paramètres, rubrique Marketplace, avec un onglet pour parcourir le catalogue et un onglet des projets installés ;
• il propose des intégrations, des cartes de tableau de bord, des thèmes et des modèles, partagés par la communauté ;
• aucun compte GitHub n'est nécessaire pour installer ou mettre à jour depuis le catalogue ;
• si vous aviez HACS, la migration est automatique au premier démarrage après la mise à jour : vos extensions restent installées et continuent de recevoir leurs mises à jour, puis HACS lui-même est retiré.

À la première ouverture, le Marketplace affiche un avertissement : ces projets ne sont ni testés, ni audités, ni pris en charge par le projet Home Assistant. Il faut cocher « I understand the risks and agree » pour installer ou mettre à jour. Ce n'est pas une formalité juridique à cocher sans lire. C'est la phrase la plus importante de ce guide.

Le risque, dit franchement

Une intégration du Marketplace est du code Python chargé dans Home Assistant lui-même. Elle a accès à tout ce que Home Assistant voit : vos appareils, vos serrures, vos caméras, vos mots de passe d'intégrations, et le réseau de la maison. Une carte de tableau de bord est du code JavaScript qui s'exécute dans le navigateur de chaque personne qui ouvre le tableau.

Ce code est écrit par un particulier. Dans l'immense majorité des cas, c'est un passionné honnête. Mais trois choses arrivent réellement :

• l'abandon : l'auteur passe à autre chose, et l'extension casse à la mise à jour mensuelle suivante. C'est de loin le cas le plus fréquent ;
• la casse au démarrage : une intégration défectueuse peut empêcher Home Assistant de démarrer correctement ;
• le changement de main : un projet populaire repris par quelqu'un d'autre, ou un compte d'auteur piraté, et une mise à jour apporte du code que personne n'a relu.

Le Marketplace permet aussi d'ajouter un projet par son lien (« Add from link »), hors du catalogue. Cela demande de relier un compte GitHub, et c'est le niveau de confiance le plus bas : personne n'a même vérifié la structure du projet. Réservez-le aux cas où vous savez précisément ce que vous installez et pourquoi.

Choisir une extension : la grille

Avant d'installer, ouvrez la fiche du projet. Le Marketplace affiche le nombre de téléchargements, les étoiles du dépôt et la version minimale de Home Assistant requise ; la page du dépôt montre la date de dernière modification et les tickets ouverts. Posez-vous ces questions, dans cet ordre :

Une extension qui échoue à deux de ces lignes ne mérite pas une place sur une installation qui pilote le chauffage ou la porte d'entrée. Pour un thème ou une carte décorative, vous pouvez être plus souple : au pire, le tableau s'affiche mal.

Et gardez en tête la règle du guide Construire un tableau de bord Home Assistant sur mesure : rien d'indispensable ne doit reposer sur une seule extension de la communauté.

Les mises à jour

Toutes les familles se mettent à jour au même endroit : la rubrique des mises à jour des paramètres. Depuis 2026.11, les projets du Marketplace y apparaissent à côté de Home Assistant et des Apps.

• Une mise à jour à la fois, après une sauvegarde. Si trois choses changent ensemble et que quelque chose casse, vous ne saurez pas laquelle.
• Lisez les notes des extensions de la communauté avant de mettre à jour : c'est là que l'auteur annonce un changement qui casse.
• Une intégration du Marketplace s'installe sans redémarrage, mais ses mises à jour en demandent encore un : Home Assistant le signale et propose de le lancer.
• Une extension ignorée depuis longtemps est un signal : soit elle n'est plus maintenue, soit vous ne vous en servez plus. Dans les deux cas, désinstallez-la.

Une courte liste de départ

Chacune a une raison d'être là. Si la raison ne vous concerne pas, ne l'installez pas.

Intégrations officielles

• Application mobile (Mobile App) : elle s'ajoute toute seule quand vous connectez l'application compagnon. Elle fait de votre téléphone un capteur de présence et un récepteur de notifications : la base de presque toutes les automatisations utiles.
• Météo-France : prévisions et vigilances locales, utiles pour fermer les volets avant l'orage ou décaler un arrosage.
• MQTT : indispensable dès que vous utilisez Zigbee2MQTT ou des capteurs faits maison.

Apps officielles (Home Assistant OS)

• File editor : modifier un fichier de configuration depuis le navigateur, sans ouvrir de session sur la machine. Pratique pour suivre un tutoriel qui demande trois lignes de YAML ; à arrêter quand on ne s'en sert pas.
• Mosquitto broker : le serveur MQTT décrit plus haut, à n'installer que si un appareil ou Zigbee2MQTT en a besoin.
• Terminal & SSH : un terminal pour diagnostiquer quand l'interface ne répond plus. On ne s'en sert presque jamais, mais ce jour-là, on est content de l'avoir.

Marketplace

Aucune n'est indispensable pour démarrer, et c'est voulu. La plus courante est un jeu de cartes de tableau de bord plus compactes, comme Mushroom : c'est un bon premier essai, parce qu'au pire il ne touche que l'affichage. Passez-la quand même à la grille ci-dessus le jour où vous l'installez : ce guide ne peut pas savoir si elle sera encore maintenue quand vous le lirez.

Cas concret

Claire veut voir dans Home Assistant la consommation de son chauffe-eau, branché sur une prise connectée d'une marque peu connue. Un forum lui conseille « l'intégration XYZ sur HACS ».

1. Elle cherche d'abord la marque dans la liste officielle des intégrations : rien.
2. Elle vérifie si la prise parle un protocole standard (Zigbee, Matter) : non, elle passe par le nuage du fabricant.
3. Elle ouvre la fiche de l'extension dans le Marketplace : dernière modification il y a quatorze mois, une seule personne, une trentaine de tickets « ne marche plus » sans réponse, et elle dépend de l'API non officielle du fabricant.
4. Deux signaux d'alarme, sur un appareil branché sur le réseau électrique : elle n'installe pas.
5. Elle remplace la prise par une prise Zigbee à mesure de consommation, reconnue nativement (voir Passer ses appareils en Zigbee avec Home Assistant). Coût : une quinzaine d'euros, et plus aucune dépendance à un particulier ni à un nuage.

Le bon réflexe n'était pas de trouver la bonne extension, mais de se demander si l'appareil méritait d'en avoir besoin.

Erreurs fréquentes

• Chercher une App alors qu'il faut une intégration, ou l'inverse. C'est précisément la confusion qui a motivé le renommage de 2026.2. Une intégration connecte, une App tourne à côté.
• Chercher la rubrique Apps sur une installation en conteneur. Elle n'existe pas dans ce mode : faites tourner le logiciel dans un conteneur voisin.
• Installer Mosquitto sans l'intégration MQTT (ou l'inverse), puis conclure que « MQTT ne marche pas ».
• Suivre un tutoriel qui fait installer HACS sur une version 2026.11 ou plus récente. HACS ne s'installe plus : tout est dans le Marketplace.
• Cocher l'avertissement du Marketplace sans le lire, puis installer une intégration abandonnée sur la serrure de la porte d'entrée.
• Ajouter un projet par son lien parce qu'il n'est pas dans le catalogue, sans se demander pourquoi il n'y est pas.
• Installer ou mettre à jour sans sauvegarde, et plusieurs choses à la fois.
• Accumuler des Apps « pour essayer » sur un Raspberry Pi, puis se plaindre de lenteurs.

À retenir

• Intégration = connecter Home Assistant à un appareil ou un service. App (ex-module complémentaire) = logiciel qui tourne à côté, sur Home Assistant OS seulement. Marketplace (ex-HACS) = code de la communauté, non testé ni audité par le projet.
• Le mode d'installation décide de l'accès aux Apps : pas d'Apps en conteneur.
• L'officiel d'abord : avant toute extension de la communauté, vérifiez la liste officielle des intégrations.
• Une extension de la communauté a accès à tout ce que voit Home Assistant. Jugez-la sur des critères vérifiables : dernière modification, utilisateurs, tickets, nombre d'auteurs, dépendance à une API non officielle.
• Sauvegarde avant chaque ajout et chaque mise à jour, une chose à la fois.

Mini-exercice

Faites l'inventaire de ce qui étend déjà votre installation :

1. Dans les appareils et services, comptez vos intégrations et repérez celles qui portent une mention d'intégration personnalisée (« custom ») : ce sont celles de la communauté.
2. Si vous êtes sur Home Assistant OS, ouvrez Apps et notez, pour chacune, à quoi elle vous sert. Celles pour lesquelles vous n'avez pas de réponse sont candidates à la désinstallation.
3. Pour chaque extension de la communauté, ouvrez sa fiche et appliquez la grille : date de dernière modification, nombre d'utilisateurs, tickets ouverts.

Si une extension échoue à deux critères de la grille et pilote quelque chose d'important, vous venez de trouver le prochain point de panne de votre maison. Notez-la, cherchez une alternative officielle, et prévoyez de la remplacer avant qu'elle ne casse d'elle-même.