Que fait le fichier configuration.yaml de Home Assistant (et pourquoi vous devriez vous en soucier)

Bien qu’il soit personnalisable presque à l’infini, Home Assistant peut sembler relativement simple en surface. Parfois, cependant, vous constaterez peut-être que vous devez configurer des intégrations ou apporter des modifications manuellement, et à ce moment-là, vous pourriez être dirigé vers le configuration.yaml déposer.

Voici ce que fait ce fichier, comment le modifier et pourquoi vous n'avez probablement pas trop à vous en soucier.

Le configuration.yaml le fichier sert à plusieurs fins

Le configuration.yaml Le fichier est un ensemble d'instructions généralement situées sous le config répertoire sur votre serveur Home Assistant. L'extension YAML fait référence au type de formatage utilisé dans le fichier (initialement considéré comme l'abréviation de Yet Another Markup Language, finalement adapté à YAML Ain't Markup Language).

Le format YAML est conçu pour être un code lisible par l'homme, utilisant des règles simples comme l'indentation. Il est largement utilisé sur la plateforme Home Assistant, par exemple dans les automatisations et les scripts. Il est conçu dans le but d'être accessible, de sorte que le formatage ne soit pas une barrière à l'entrée, même si vous devrez naturellement toujours comprendre les concepts de base de Home Assistant tels que les entités et les valeurs.

On peut soutenir que les principales raisons pour lesquelles vous souhaiterez peut-être apporter des modifications au configuration.yaml doivent faire appel à certains automatismes ou apporter des modifications au fonctionnement de Home Assistant en dehors de l'interface utilisateur principale.

La grande majorité des intégrations que vous rencontrerez lors de l'utilisation de la plate-forme sont ajoutées via l'interface utilisateur principale, avec des panneaux de configuration et des processus de configuration pratiques. Si vous décidez de sortir un peu plus des sentiers battus et d'installer des intégrations en dehors de la version principale de Home Assistant, par exemple à partir du Home Assistant Community Store, vous constaterez peut-être que vous devez apporter des modifications au configuration.yaml afin que ces intégrations s'exécutent au démarrage de votre serveur.

Cela peut être aussi simple que d'ajouter quelques lignes de code que vous pouvez copier et coller, ou cela peut nécessiter un processus de configuration plus complexe dans lequel vous définissez des paramètres afin que l'intégration fasse ce que vous voulez. Une fois, j'ai ajouté une intégration axée sur les transports en commun à mon tableau de bord Home Assistant qui m'obligeait à me connecter à l'API nécessaire et à référencer les bonnes données d'arrêt et de trajet dans le YAML.

Une autre utilisation du configuration.yaml Le fichier est lors de la modification du fonctionnement de Home Assistant. Un bon exemple est la personnalisation de la barre latérale afin de créer des raccourcis vers différentes parties de la plateforme.

Le fichier est également utilisé pour appeler d'autres fichiers YAML contenant des scripts, des automatisations, des scènes et vos thèmes frontend. Bien qu'il n'y ait aucune raison de les modifier pour la plupart, vous pouvez ajouter les vôtres si vous le souhaitez.

Modification du configuration.yaml déposer

Vous pouvez modifier le configuration.yaml fichier à l’aide d’un éditeur de texte classique, à condition que vous y ayez accès. La plupart le trouveront sous le /config/ répertoire sur votre serveur, tandis que les utilisateurs de Docker le trouveront sous le noyau /homeassistant/ annuaire.

Si vous exécutez Home Assistant sur un serveur comme un Raspberry Pi ou si vous utilisez une machine virtuelle pour exécuter Home Assistant sur un autre système d'exploitation ; accéder à ce fichier peut être pénible. Heureusement, il existe un moyen simple de contourner ce problème en utilisant un module complémentaire appelé Éditeur de fichiers.

Vous pouvez installer le module complémentaire Éditeur de fichiers sous Paramètres > Modules complémentaires en cliquant sur le bouton « Magasin de modules complémentaires » et en le recherchant. Une fois configuré, lancez l'éditeur de fichiers sous Paramètres > Modules complémentaires > Éditeur de fichiers > Ouvrir l'interface utilisateur Web. J'ai créé un raccourci pour cela afin de rendre les choses encore plus faciles.

Par défaut, votre configuration.yaml le fichier sera le premier à s'ouvrir. Ici, vous pouvez ajouter toutes les lignes de votre choix et utiliser des commentaires (#) au-dessus de chacune pour ajouter des descriptions afin que vous sachiez ce que font les différentes sections. Lorsque vous avez terminé, cliquez sur le bouton rouge du stylo « Enregistrer » en bas de l'écran.

Afin de donner suite à toute modification apportée à votre configuration.yaml fichier, vous devrez redémarrer Home Assistant. Vous pouvez le faire via le menu Paramètres en cliquant sur les « trois points » dans le coin supérieur droit de la page et en choisissant « Redémarrer Home Assistant ».

Une autre option consiste à exposer votre /homeassistant/ répertoire via un partage réseau en installant le module complémentaire de partage Samba et en vous connectant à votre serveur via un autre ordinateur du réseau. De là, vous pouvez ouvrir le configuration.yaml fichier dans un éditeur de texte et apportez les modifications que vous souhaitez.

Ne vous inquiétez pas jusqu'à ce que vous en ayez besoin

Comme indiqué, le configuration.yaml Le fichier n'est pas quelque chose avec lequel vous devrez interagir jusqu'à ce que vous constatiez soudainement que vous devez le faire. Les intégrations que vous utiliserez quotidiennement sont construites autour d'interfaces utilisateur simples et n'ont pas besoin d'être appelées manuellement à l'aide de ce fichier.

Parfois, vous pourriez trouver une intégration obscure que vous devrez utiliser pour intégrer un appareil ou un service de niche dans votre serveur. Devoir jouer avec le configuration.yaml ne signifie pas que l'intégration ne vaut pas votre temps, et vous ne devriez pas avoir peur de l'utiliser.

Comme toujours, assurez-vous simplement d'avoir configuré une sauvegarde Home Assistant afin de pouvoir annuler toute modification indésirable et restaurer votre serveur si nécessaire.