DomotiqueHome Assistant & AlexaTutoriels domotique

[TUTORIEL] HACS une intégration indispensable dans Home Assistant !

HACS vous offre une interface utilisateur puissante qui peut gérer vos personnalisations

HACS Home AssistantHACS 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. 

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!

HACS, le store qui regroupe toutes les intégrations conçues par la communauté pour la communauté !

Exigences pour installer HACS

Quelques conditions préalables sont à connaitre avant de ce 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

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.

hacs.zip home assistant

Extraire le contenu du dossier

Décompressez le fichier « hacs.zip » que vous venez de télécharger.

HACS 0.24.0
HACS 0.24.0

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.

custom_components home assistant
custom_components home assistant

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

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.

custom_components hacs
custom_components hacs

 

 

 

 

 

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 » :

GitHub token hacs
Résulat final de la création du token HACS dans GitHub

 

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 ».

hacs name github

github generate token hacs

 

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

token hacs

Intégration dans Home Assistant

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

Depuis Configuration > Integrations :

Configuration > Integrations hassio
Configuration > Integrations hassio

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é ! 🙂
HACS Dashboard
HACS Dashboard

 

Tags

Aurélien Buret

Passionné de high tech et de domotique, j'ai récemment rejoint la rédaction du site pour partager avec vous ma passion pour la domotique et en particulier mes découvertes sur Home Assistant.

8 commentaires

    1. Bonjour, ce n’est pas possible un dossier entier. Soit fichier par fichier (très long..)
      Samba share est plus adapté pour cela 🙂

    1. Bonjour,
      Il suffit d’installer Samba Share depuis la page « Add-on officiels » et ensuite insérer votre identifiant et mot de passe Home Assistant dans les champs ci dessous :
      « username »: « votre_identifiant_HA »,
      « password »: « votre_mdp_HA »,

      Enregistrez la configuration puis démarrez l’add-on.Vous pouvez y accéder depuis un ordinateur (depuis windows : https://www.microlinux.fr/windows-10-client-samba/ ) Adresse-IP-de-votre-raspberry/config pour accéder au dossier

  1. Bonsoir, je n’arrive pas au bout, une fois HACS trouvé depuis integration effectué ça tourne en rond « veuillez patienter installation en cours » puis rien. J’ai loupé quelque chose ? Merci pour votre aide.

  2. Bonjour, j’ai bien installé hacs et il semble fonctionner normalement. J’ai voulu ensuite installer un thème et une intégration mais aucun des deux n’est visible dans Home Assistant. Une idée ?

  3. Bonjour, je me retrouve avec le même problème. Je tourne en rond, lors de l’intégration de HACS, il me remets la liste de choix… Merci pour vos articles.

Laisser un commentaire

Bouton retour en haut de la page
Fermer