Comment vérifier que Home Assistant utilise le fichier de configuration attendu

Home Assistant utilise le fichier de configuration attendu uniquement lorsque le répertoire de configuration signalé par l’environnement d’exécution, le chemin hôte monté et un test de validation contrôlé pointent tous vers le même fichier.

Cette confusion est fréquente lorsque /config existe à l’intérieur d’un conteneur, mais correspond à un autre répertoire sur l’hôte, ou lorsqu’un ancien montage bind et une copie récemment modifiée contiennent tous deux configuration.yaml. Commencez par relever le chemin utilisé par l’environnement d’exécution, retracez son montage sans le modifier, comparez l’identité et les horodatages des fichiers, puis utilisez un marqueur inoffensif et réversible pour prouver quelle arborescence est lue par l’instance en cours d’exécution.

Relever le répertoire de configuration signalé par l’instance en cours d’exécution

Ouvrez les informations système depuis l’instance Home Assistant en cours d’exécution et relevez exactement le répertoire de configuration affiché. Notez également le type d’installation, la version de Core, le nom du conteneur ou de la machine virtuelle, ainsi que l’heure du dernier redémarrage réussi. Cela établit la vue de l’environnement d’exécution avant que les chemins hôtes ne compliquent le diagnostic.

Les explications de la communauté montrent pourquoi /config peut désigner un chemin interne tandis que le répertoire hôte correspondant diffère selon l’installation. La distinction utile est entre l’intérieur et l’extérieur du conteneur, et non l’existence d’un emplacement universel dans le système de fichiers.

Si le répertoire indiqué contient le fichier que vous avez modifié dans le même espace de noms d’exécution, passez à la vérification du fichier. Si ce n’est pas le cas, arrêtez de modifier cette copie. Si l’interface est indisponible, inspectez le processus en cours d’exécution ou les arguments et montages du conteneur au lieu de vous fier à un ancien tutoriel.

Retracer le chemin hôte au moyen du montage actif

Inspectez le conteneur en cours d’exécution ou le service Compose et trouvez la source mappée vers le répertoire de configuration utilisé par l’environnement d’exécution. Résolvez les chemins relatifs depuis le véritable répertoire du projet Compose. Pour une installation sur machine virtuelle ou HAOS, distinguez le chemin invité des données accessibles à l’hyperviseur.

Un problème documenté dans le projet Home Assistant décrit une confusion dans laquelle l’interface affichait le chemin à l’intérieur du conteneur, alors que les données réelles de l’hôte HAOS se trouvaient ailleurs. Ce cas de divergence entre les chemins hôte et conteneur confirme qu’il faut retracer le montage plutôt que recopier son chemin exact dans une autre installation.

Comparez la source du montage actif avec le répertoire utilisé dans votre éditeur ou partage de fichiers. S’ils diffèrent, ne les fusionnez pas encore. Conservez les deux arborescences, notez leurs dates de modification et leurs tailles, puis identifiez celle qui contient le registre d’entités actuel, les automatisations et l’activité récente des journaux.

Prouver l’identité du fichier au moyen d’une modification contrôlée et sûre

Avant le test, exécutez la vérification de configuration dans le même environnement d’exécution et créez une sauvegarde de l’arborescence active. Ajoutez au fichier suspect un commentaire inoffensif au nom unique ou un autre marqueur réversible, enregistrez-le, puis vérifiez que l’horodatage change à l’emplacement correspondant au montage utilisé par l’environnement d’exécution.

Utilisez le parcours normal de validation de la configuration, puis rechargez uniquement le domaine concerné lorsque cela est possible. Si un redémarrage complet est nécessaire, redémarrez une seule fois après la validation et consultez le journal pour vérifier le fichier ou l’intégration modifié. Un redémarrage sans preuve du chemin peut simplement recharger le mauvais fichier une nouvelle fois.

L’article connexe de ZimaSpace sur le chemin des données de Home Assistant aide à distinguer l’état visible dans l’interface des fichiers de configuration persistants et des fichiers de registre qui l’ont produit.

-15% OFF

ZimaBoard 2 - Mini serveur domestique pour votre grande idée

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Corriger le montage et vérifier la persistance

Si la mauvaise source est montée, arrêtez Home Assistant, conservez les deux répertoires et corrigez uniquement la définition du montage qui recrée le conteneur. Vérifiez le propriétaire et les permissions avant le démarrage. Ne remplacez pas une arborescence plus récente par une ancienne, sauf si vous avez explicitement choisi quelles données doivent prévaloir.

Après le démarrage, répétez les vérifications du chemin d’exécution, du montage, de l’horodatage, de la configuration et du marqueur. Un résultat positif prouve que le fichier attendu est bien lu, que les registres actuels sont toujours présents et que le même mappage persiste après la recréation du conteneur ou le redémarrage de l’hôte.

Revenez au montage précédent si Home Assistant démarre sans configuration, perd des intégrations ou signale des erreurs de permissions. Si le mappage reste ambigu, transmettez le type d’installation, le répertoire d’exécution, la source et la destination du montage, ainsi qu’une liste de répertoires expurgée. Ne supprimez les arborescences en double qu’après avoir vérifié la récupération de manière indépendante.