HACS ou plus précisément Home Assistant Community Store est une intégration indispensable pour découvrir et ajouter des personnalisations ainsi que des intégrations conçues par la communauté pour enrichir notre instance Home Assistant.
Nous allons donc, ensemble, installer ce paquet communautaire qui nous fera gagner énormément de temps par la suite.
Mise à jour 06/05/2022 : nouvelle méthode d’autorisation
HACS est un gestionnaire qui vous aide à installer et maintenir des éléments personnalisés pour Home Assistant. Il peut vous aider à découvrir de nouvelles choses impressionnantes! Les Alexiens
HACS : les intégrations Home Assistant conçues par la communauté pour la communauté !
Pré-requis et exigences pour installer HACS
Quelques conditions préalables sont à connaitre avant de se lancer dans l’installation :
- La version de votre serveur Home Assistant doit être 0.98.0 ou supérieur
- Un compte GitHub (Gratuit)
- Accès au système de fichiers où se trouve Home Assistant (Add-on officiels : Samba ou File editor)
Installation de HACS sur Home Assistant
Je vais vous guider avec différentes étapes pour installer correctement le store communautaire.
Télécharger la dernière version
Pour télécharger la dernière version, il vous suffit de vous rendre sur la page GitHub du projet.
Rendez vous en bas de la page puis cliquez sur « hacs.zip » afin de récupérer le projet sur votre ordinateur.
Extraire le contenu du dossier
Décompressez le fichier « hacs.zip » que vous venez de télécharger.
Vous devriez avoir un dossier qui ressemble à ceci. Lors de la rédaction de ce tutoriel, nous sommes à la version 0.24.0, il est possible que vous n’ayez pas les mêmes fichiers, ce n’est pas grave, cela est sûrement dû à une amélioration du projet.
Créer le dossier custom_components
Une fois votre dossier décompressé, rendez-vous sur votre interface Home Assistant dans l’onglet File editor.
Créez un dossier « custom_components » si vous ne l’avez pas créé précédemment pour une autre intégration. Celui-ci doit apparaitre au même endroit que votre fichier « configuration.yaml » comme ci-dessus.
Déplacer le dossier HACS
Maintenant que nous avons un dossier « custom_components » nous allons y ajouter notre dossier « hacs » à l’aide du plugin Samba share ou directement depuis File editor.
Vous devriez avoir cette arborescence :
Configuration de HACS dans Home Assistant
L’installation de l’intégration est terminée. Nous allons maintenant le configurer pour cela, vous aurez besoin d’un compte GitHub.
Intégration dans Home Assistant
Le plus compliqué est fini, nous allons maintenant intégrer tout cela dans Home Assistant.
Depuis Configuration > Integrations :
Cliquez sur le « + » en bas à droite de la page puis cherchez « hacs » :
Insérez votre token GitHub précédemment généré ainsi que le reste des informations comme sur la capture d’écran ci-dessous :
Appuyez sur le bouton « soumettre » afin de finaliser l’installation de Home Assistant Community Store.
Générer un code
La méthode a désormais changé ! Inutile d’en passer par la création d’un token pour connecter HACS à GitHub, un système de code bien plus simple a été mis en place.
Si vous utilisiez déjà l’intégration précédente, nous vous recommandons de mettre à jour HACS :
- Rendez-vous dans Configuration > Intégration
- Supprimez HACS,
- Installez la dernière version de HACS,
- Validez avec la nouvelle clé d’autorisation fraîchement générée,
- Redémarrez Home Assistant.