[TUTORIEL] HACS : installation dans Home Assistant

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/04/2021 : 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. 

Attention, le dossier .translations doit être présent peu importe la version.

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 :

Redémarrez Home Assistant une fois avant de passer à l'étape suivante.

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.

Jeton d'accès personnel Github

Pour fonctionner, HACS doit récupérer des informations sur les projets de la communauté à l'aide de l'API de Github. Ce jeton aura un accès en lecture seule aux informations publiques et ne sera utilisé que par notre nouveau gestionnaire pour appeler l'API de Github.

Depuis la page Personal Access Tokens sur GitHub, créez un nouveau jeton (token) en cliquant sur le bouton “Generate new token” :

Une page comme celle ci-dessous vous sera proposée. Vous n'avez besoin de cocher aucune des cases. Donnez-lui un nom comme “HACS” puis en bas de la page cliquez sur le bouton “generate token”.

Votre token est généré, ce sera la seule fois que vous pouvez le voir et le copier !

Méthode ci-dessus désuète !

Intégration dans Home Assistant

Le plus compliqué est fini, nous allons maintenant intégrer tout cela dans Home Assistant.

Depuis Configuration > Integrations :

Avant que Home Assistant Community Store puisse apparaître dans la liste, vous devez vider le cache de votre navigateur.

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.

Félicitations! HACS est intégré à Home Assistant, vous pouvez dès maintenant visionner les nombreuses intégrations proposées par la communauté ! 🙂

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 :

  1. Rendez-vous dans Configuration > Intégration
  2. Supprimez HACS,
  3. Installez la dernière version de HACS,
  4. Validez avec la nouvelle clé d'autorisation fraîchement générée,
  5. Redémarrez Home Assistant.

 

Plusieurs plumes de passionnés d'Alexa pour vous concocter des articles à 4 mains ou plus... Une écriture collaborative pour aborder les sujets les plus pointus ou transversaux, les meilleurs bons plans domotique et maison connectée du web, et bien plus encore...