Un package Home Assistant permet de réunir les éléments YAML d’un même appareil ou d’un même usage. Par exemple, les capteurs de consommation, les assistants et les automatisations du lave-vaisselle peuvent être regroupés dans un seul fichier. On retrouve ainsi plus facilement le code quand il faut le modifier.
La vidéo est en espagnol. Vous pouvez suivre le même principe avec l’exemple ci-dessous.
1. Activer le dossier des packages
Sauvegardez votre configuration. Créez un dossier packages à côté de configuration.yaml. Dans ce fichier, ajoutez packages: à l’intérieur de la section homeassistant:.
homeassistant:
packages: !include_dir_named packagesSi la section homeassistant: existe déjà, ajoutez la ligne à côté de ses autres clés. Si des packages sont déjà chargés, conservez la méthode d’inclusion en place. Les fichiers d’automatisations et de scripts existants peuvent continuer à être utilisés.
Avec !include_dir_named, le nom du fichier devient le nom du package. Les clés d’intégration telles que input_boolean: ou automation: se placent directement à la racine du fichier. Donnez un nom unique à chaque fichier. Pour !include_dir_merge_named, la structure diffère. Elle est détaillée dans la documentation officielle des packages.
2. Essayer avec un petit package
Enregistrez l’exemple dans packages/package_test.yaml. Il crée un assistant de test et une automatisation qui affiche une notification persistante lorsque cet assistant est activé.
input_boolean:
package_test:
name: Test du package
automation:
- id: package_test_notification
alias: Test du package
triggers:
- trigger: state
entity_id: input_boolean.package_test
to: "on"
actions:
- action: persistent_notification.create
data:
message: Home Assistant a chargé le package de test.Ouvrez Outils de développement → YAML et lancez la vérification de la configuration. Si elle réussit, redémarrez Home Assistant. Activez input_boolean.package_test et vérifiez que la notification s’affiche. Désactivez-le avant de recommencer le test.
Si le package n’est pas chargé, vérifiez le nom du dossier, l’extension .yaml, l’indentation et les clés au premier niveau. Si le package est chargé mais que l’automatisation ne se déclenche pas, vérifiez l’identifiant de l’entité et consultez la trace. Voir aussi le guide de dépannage de Home Assistant.
3. Déplacer un usage à la fois
Commencez par un usage simple et recensez ses automatisations, scripts, capteurs et assistants. Dans la vidéo, je montre comment préparer ce travail avec un assistant de code. Faites-lui d’abord proposer un inventaire et les modifications, puis relisez-les avant de les appliquer. Conservez les identifiants et les références existants et vérifiez que chaque définition déplacée ne figure qu’une seule fois. Faites particulièrement attention aux id des automatisations et aux champs unique_id.
Les éléments gérés depuis l’interface peuvent y rester. Le package peut simplement faire référence à leurs identifiants. Laissez Home Assistant gérer ses fichiers de stockage internes.
Validez la configuration, redémarrez et testez l’ensemble avant de passer à l’usage suivant. Si le changement échoue, restaurez la version précédente puis validez-la. On peut appliquer la même méthode pour rassembler la connexion et les capteurs YAML d’un appareil comme l’onduleur Salicru.
Continúa leyendo
Siguiente guía relacionada · 6 min de lectura
Notifications Telegram et Home Assistant : comment résoudre le changement de 2026.11
Vos notifications Telegram n’arrivent plus après une mise à jour de Home Assistant ? Si vos automatisations utilisaient l’ancien notificateur, le changement introduit dans…
Continuar con este artículo

