Pourquoi Home Assistant perd-il l’accès aux données persistantes après la recréation de la stack ?

Recréer une pile Docker ou Compose Home Assistant ne devrait pas effacer la configuration lorsque les mêmes données persistantes /config sont à nouveau montées. Lorsque l’assistant de configuration s’affiche ou que des intégrations semblent manquer après la recréation, il faut d’abord supposer que le nouveau conteneur voit une vue différente du stockage, et non que Home Assistant a supprimé l’état du foyer.

Examinez le montage effectif, le chemin sur l’hôte, le volume nommé, les fichiers cachés et les permissions avant de restaurer une ancienne sauvegarde. Un répertoire vide incorrect peut donner exactement l’impression d’une perte de configuration, alors que les données d’origine sont toujours intactes ailleurs sur l’hôte.

Vérifier ce qui est réellement monté sur /config

Inspectez le conteneur en cours d’exécution et confirmez la source du montage associée à /config. Comparez-la avec l’ancien fichier Compose ou l’enregistrement du déploiement au lieu de vous fier à un nom de dossier qui semble familier.

Les montages de liaison Docker remplacent la vue du conteneur sur le répertoire cible, et la documentation des montages de liaison indique que le montage d’un répertoire hôte sur un chemin de conteneur non vide masque les fichiers qui s’y trouvaient déjà. Un chemin source vide ou incorrect fait donc voir à Home Assistant un /config vide.

Ne lancez pas l’assistant de configuration et ne commencez pas à créer de nouvelles intégrations tant que le montage n’a pas été vérifié. De nouvelles écritures dans le mauvais répertoire rendraient la récupération ultérieure plus confuse.

Distinguer les montages de liaison des volumes nommés

Une pile Compose peut utiliser un chemin explicite sur l’hôte ou un volume nommé géré par Docker. Recréer un projet avec un nom de projet, un nom de volume ou un chemin différent peut créer un nouveau stockage persistant vide alors que l’ancien volume existe toujours.

Un guide actuel sur les volumes Docker explique que les volumes nommés stockent les données indépendamment des conteneurs individuels et peuvent être rattachés après le remplacement d’un conteneur. Supprimer un conteneur est donc différent de supprimer ou de remplacer son stockage persistant.

Répertoriez les anciens et les nouveaux volumes, inspectez leurs points de montage via Docker et comparez leurs dates de création ainsi que leur contenu. Évitez les commandes de nettoyage tant que vous ne savez pas quel volume contient l’état de référence de Home Assistant.

Les fichiers cachés peuvent donner l’impression qu’une copie est complète alors qu’elle ne l’est pas

Home Assistant stocke d’importantes données gérées depuis l’interface dans des chemins cachés tels que .storage. Une copie effectuée dans un shell avec un motif tel que *, ou un gestionnaire de fichiers qui masque les fichiers commençant par un point, peut déplacer les fichiers YAML tout en laissant silencieusement de côté des données essentielles concernant les registres et les intégrations.

Un cas de migration de Docker vers Compose datant de 2025 a reproduit exactement cette situation : une opération de copie avait omis ou mal géré des données cachées de Home Assistant, et la migration ne s’est stabilisée qu’après la copie correcte de l’ensemble de l’arborescence de configuration et de ses métadonnées.

Comparez les listes de répertoires en incluant les fichiers cachés et vérifiez le propriétaire, les horodatages ainsi que la présence des répertoires cachés attendus avant de conclure que les données elles-mêmes sont endommagées.

Featured

ZimaCube 2 NAS personnel Cloud à domicile

ZimaCube2

$799.00 - $2,499.00

Buy Now

Vérifier les permissions avant de recopier les données

Le bon répertoire peut tout de même sembler inutilisable lorsque le conteneur recréé n’a pas l’autorisation de le lire ou d’y écrire. Cela arrive souvent après le déplacement des données vers un nouveau système de fichiers, la modification du mode Docker, la restauration depuis un autre hôte ou la modification des correspondances UID/GID.

Un guide de dépannage de Docker Engine vérifié en 2026 attribue ces défaillances au véritable chemin sur l’hôte, à l’UID/GID du conteneur, à l’accès aux répertoires parents, au mode de montage et aux limites de sécurité. Un montage en lecture seule ou une discordance de propriétaire peut empêcher Home Assistant de mettre à jour son état même lorsque les fichiers sont visibles.

Corrigez précisément le problème de propriétaire ou de montage au lieu d’appliquer des permissions accessibles à tous à l’ensemble de l’arborescence de configuration.

Recréer la pile uniquement après avoir vérifié le chemin persistant

Utilisez la définition Compose exacte qui fonctionnait, le tag d’image, le mode réseau, les périphériques et la source /config connus pour être corrects. Démarrez Home Assistant et vérifiez que les utilisateurs, tableaux de bord, intégrations, automatisations et assistants attendus sont de nouveau présents avant d’autoriser les migrations ou de nouvelles modifications de configuration.

Le flux de récupération d’un seul conteneur de ZimaSpace applique la même règle : inspecter les montages effectifs et reconnecter les dépendances saines avant de restaurer ou de remplacer d’autres éléments de la pile.

Si les données de référence ont réellement disparu, passez à la restauration d’une sauvegarde. Si elles sont présentes mais que le nouveau conteneur ne peut pas les voir ou les modifier, le problème se situe au niveau du mappage du stockage ou des permissions, et non dans la configuration de Home Assistant elle-même.