Comment déplacer les données de Home Assistant sans perdre les utilisateurs, l’historique ni les paramètres

Déplacez les données de Home Assistant en préservant l’état complet de l’application et en gardant l’ancienne instance intacte jusqu’à ce que la nouvelle ait passé une validation complète.

Les utilisateurs et les paramètres ne se limitent pas aux fichiers YAML visibles, et l’historique ne se recrée pas en copiant un tableau de bord. Une migration doit préserver le répertoire de configuration de Home Assistant ou une sauvegarde prise en charge, la base de données Recorder lorsque l’historique est important, les données masquées, les secrets, les composants personnalisés, ainsi que les mappages d’appareils et de réseau spécifiques à l’environnement d’exécution. La séquence la plus sûre consiste à faire l’inventaire, effectuer une copie cohérente, démarrer de manière isolée, valider, puis retirer la source.

Inventoriez l’état persistant et les dépendances externes avant le déplacement

Pour une installation en conteneur, considérez l’intégralité du répertoire de configuration Home Assistant monté comme l’unité centrale de récupération, plutôt que de sélectionner quelques fichiers connus. Les données masquées sous .storage, les données d’authentification, les registres d’intégration, les tableaux de bord, les automatisations et la base de données Recorder par défaut peuvent toutes se trouver sous ce chemin. MariaDB, MQTT, les passerelles Zigbee, les coffres de secrets ou les montages NAS externes doivent être répertoriés séparément.

Un guide de migration de conteneur Home Assistant montre pourquoi le déplacement de l’intégralité du répertoire de configuration est plus sûr que la reconstitution de l’état fichier par fichier, et insiste sur l’arrêt de l’ancien conteneur avant une copie brute du système de fichiers.

Créez un manifeste indiquant le chemin source, le chemin cible, l’UID/GID propriétaire, l’emplacement de la base de données, les périphériques USB ou série, le mode réseau, les ports publiés, les services externes et la version actuelle de Home Assistant. Si une dépendance n’est pas documentée, ne supprimez pas l’ancienne instance. La migration n’est prête que lorsque le nouvel hôte peut reproduire cette dépendance à partir d’informations écrites.

Créez un point de restauration cohérent avant de copier les données

Utilisez la sauvegarde intégrée ou une autre méthode tenant compte de l’application lorsque votre installation le permet. Si vous effectuez une copie brute depuis un conteneur, arrêtez Home Assistant avant de copier la base de données de configuration active et les fichiers associés. Une simple copie à chaud peut capturer les fichiers de l’application à des moments différents, ce qui est l’inverse d’une migration maîtrisée.

La refonte des sauvegardes de Home Assistant a étendu la prise en charge de la restauration entre les méthodes d’installation, ce qui fait d’une sauvegarde prise en charge une solide limite de portabilité lors d’un changement d’environnement d’exécution. La leçon pratique du rétablissement d’une sauvegarde entre installations est que le nouvel environnement d’exécution peut changer, tandis que l’état de l’application reste la limite de continuité.

Conservez deux copies : un point de récupération pré-déplacement laissé intact et une copie de travail utilisée pour la migration. Ne laissez pas la nouvelle instance Home Assistant démarrer avec l’unique copie source fiable. Si la cible effectue une migration ou écrit un nouvel état de registre, vous devez toujours disposer d’un chemin propre pour revenir à l’ancienne version et à l’ancien hôte.

Recréez séparément les mappages matériels et réseau spécifiques à l’environnement d’exécution

Les données de l’application ne recréent pas automatiquement les chemins des périphériques de l’hôte. Les coordinateurs USB Zigbee ou Z-Wave peuvent apparaître sous un autre nom de périphérique, l’accès Bluetooth peut différer, le réseau de l’hôte peut modifier la découverte, et les bases de données ou courtiers MQTT externes peuvent être accessibles via d’autres adresses. Reconstituez explicitement ces interfaces avant de conclure qu’une intégration indisponible indique une perte de données.

Un guide indépendant de migration de conteneur vers HAOS montre que la restauration de l’état de Home Assistant Core ne recrée pas automatiquement les services associés tels que MQTT, Zigbee2MQTT ou Node-RED. Sa séquence de migration avec remappage des services associés vérifie également la continuité de l’historique Recorder, l’accès au coordinateur USB et le maintien de l’ancienne pile arrêtée mais intacte comme voie de restauration.

Démarrez la cible sur un chemin LAN contrôlé et évitez d’exécuter les deux instances avec les mêmes radios, webhooks, comptes cloud ou automatisations, sauf si vous les avez délibérément isolées. Deux instances Home Assistant actives peuvent envoyer des actions en double ou se disputer le même coordinateur, donnant l’impression qu’une migration correcte des données est défaillante.

Featured

ZimaCube 2 NAS personnel Cloud à domicile

ZimaCube2

$799.00 - $2,499.00

Buy Now

Validez les utilisateurs, l’historique, les paramètres et le contrôle des appareils avant le basculement

Connectez-vous avec un compte existant qui n’est pas administrateur, confirmez la présence d’un compte administrateur, ouvrez des graphiques historiques antérieurs au déplacement, inspectez les intégrations, déclenchez des automatisations représentatives et vérifiez un appareil de chaque protocole important. Redémarrez ensuite Home Assistant et l’hôte cible afin de prouver que l’état récupéré résiste aux événements normaux du cycle de vie.

L’explication associée de ZimaSpace sur les rôles des données persistantes de Home Assistant fournit une limite de récupération utile : l’identité durable, la configuration et l’historique doivent être traités différemment des caches ou des fichiers temporaires lors d’un déplacement.

Ne basculez le DNS, le proxy ou l’accès distant qu’une fois les tests locaux réussis. Gardez l’ancien hôte éteint mais récupérable pendant au moins un cycle d’utilisation normal. Ne le retirez que lorsque les utilisateurs, l’historique, les paramètres, les automatisations, les radios, les services externes, la création de sauvegardes et un redémarrage fonctionnent tous comme prévu ; le simple chargement réussi du tableau de bord initial ne suffit pas à justifier la suppression de la voie de restauration.