Comment éviter la perte de la configuration de Home Assistant lors des mises à niveau
Évitez de perdre la configuration de Home Assistant en faisant du système de sauvegarde intégré votre principal moyen de récupération et en considérant l’environnement d’exécution comme remplaçable. La version de Home Assistant, l’image du conteneur ou l’hôte peuvent changer ; la sauvegarde, la clé de chiffrement, la définition de l’environnement d’exécution et toutes les dépendances externes doivent rester disponibles lorsque la machine d’origine n’est plus accessible.
Les sauvegardes modernes de Home Assistant fonctionnent avec tous les types d’installation, y compris les conteneurs. Conservez séparément une copie manuelle de l’arborescence de configuration si cela présente un intérêt, mais ne construisez pas tout votre plan de mise à niveau autour de la copie manuelle de fichiers en ignorant le processus de sauvegarde et de restauration pris en charge.
Commencez par une sauvegarde intégrée, pas par un dossier YAML copié manuellement
Ne réduisez pas la « configuration » à configuration.yaml. Le système de sauvegarde pris en charge par Home Assistant capture l’état de l’application nécessaire à la récupération, notamment la configuration et le contenu de la base de données. Les flux de sauvegarde plus récents prennent également en charge l’automatisation, la conservation et les emplacements hors hôte.
La refonte des sauvegardes introduite en 2025 a ajouté des sauvegardes chiffrées automatiques, des contrôles de conservation et des emplacements de sauvegarde hors site. La sauvegarde intégrée devient ainsi le premier élément de récupération à vérifier avant une mise à niveau, au lieu de dépendre d’une copie manuelle incomplète.
Notez toutefois la racine de configuration, le choix de la base de données, les références aux secrets, les composants personnalisés, les éléments SSL ainsi que les fichiers ou services externes requis par une intégration. Une sauvegarde peut restaurer l’état de Home Assistant sans documenter automatiquement chaque périphérique USB, chemin réseau, hôte de base de données ou paramètre de conteneur qui l’entoure.
Rendez explicites la persistance du conteneur et les paramètres d’exécution
Avec Docker, vérifiez le montage de liaison ou le volume qui contient /config et conservez la définition Compose ou la commande d’exécution qui recrée le mode réseau, les mappages de périphériques, le fuseau horaire, les privilèges et les services externes. Le système de fichiers du conteneur lui-même doit rester jetable.
Une discussion sur les sauvegardes Docker de Home Assistant montre clairement le problème : lorsque les utilisateurs mappent seulement un fichier au lieu de l’intégralité du répertoire de configuration, un état important peut rester enfermé dans le conteneur et disparaître lorsque cet environnement d’exécution est remplacé.
Vérifiez le montage de l’hôte avant la mise à niveau et conservez la définition de l’environnement d’exécution à côté de la sauvegarde. La récupération est beaucoup plus rapide lorsque l’état de l’application et les instructions nécessaires pour exposer les radios, ports, réseaux et stockages sont déjà connus.
Déplacez au moins une sauvegarde chiffrée hors de l’hôte
Une sauvegarde stockée sur le même SSD protège contre certaines erreurs de configuration, mais pas contre la perte de l’hôte, la corruption du système de fichiers, le vol ou la défaillance du périphérique de stockage. Conservez au moins une copie de récupération sur un NAS, un autre ordinateur ou un emplacement de sauvegarde distant dont l’accès ne dépend pas de l’hôte Home Assistant défaillant.
Stockez également la clé de chiffrement de la sauvegarde ou le kit d’urgence en dehors de Home Assistant. Home Assistant 2026.4 a adopté pour les nouvelles sauvegardes chiffrées le format SecureTar v3 audité, doté d’un chiffrement moderne renforcé, ce qui améliore la sécurité des sauvegardes, mais fait de la conservation de la clé un élément explicite de la récupérabilité.
Versionnez les sauvegardes au lieu d’écraser toujours le même fichier. Une mise à niveau peut révéler un problème plusieurs jours plus tard, et le point de récupération le plus récent peut déjà contenir l’état migré ou endommagé auquel vous essayez d’échapper.
La sauvegarde ne remplace toujours pas la définition de votre environnement d’exécution
La configuration seule peut ne pas restaurer les radios USB, le réseau de l’hôte, le fuseau horaire, le transfert de périphériques, les services de base de données, MQTT ou les relations avec le proxy inverse. Conservez le fichier Compose, la stratégie de version de l’image, les variables d’environnement, les chemins de l’hôte, les mappages de périphériques et les dépendances de services nécessaires pour recréer l’environnement d’exécution.
Ne placez pas de secrets en clair dans un dépôt public simplement pour versionner le fichier Compose. Conservez les valeurs secrètes dans un emplacement protégé et indiquez uniquement où le processus de récupération doit les obtenir.
Le guide de déploiement de Home Assistant sur ZimaBoard de ZimaSpace fournit un contexte utile pour séparer la plateforme de serveur domestique de l’état de l’application qui doit survivre aux futures modifications de déploiement.
Effectuez un test de restauration avant que la mise à niveau ne devienne une urgence
Une sauvegarde n’est pas validée simplement parce que l’archive existe. Restaurez-la sur une cible isolée ou dans un conteneur temporaire, reconnectez si possible les périphériques et chemins représentatifs, puis vérifiez que le système revient avec les utilisateurs, tableaux de bord, intégrations, automatisations, assistants et états attendus.
Profitez du test pour détecter les mots de passe manquants, les chemins obsolètes de l’hôte, les mappages de périphériques non documentés et les bases de données surdimensionnées tant que le système de production fonctionne encore. Notez les étapes de restauration après la réussite du test ; la mémoire ne constitue pas un plan de récupération.
Juste avant la mise à niveau, créez un nouveau point de récupération, notez la version actuelle de Home Assistant et de l’image du conteneur, puis vérifiez les changements de version qui affectent vos intégrations. Conservez l’environnement d’exécution précédent jusqu’à ce que l’instance mise à niveau ait résisté à une période d’utilisation normale et à un redémarrage.
Utilisez une vérification de sécurité de mise à niveau en quatre éléments
| Élément de récupération | Protection assurée | Défaillance en cas d’absence |
|---|---|---|
| Sauvegarde intégrée | Configuration de Home Assistant et état récupérable de l’application | Aucun point de restauration pris en charge |
| Clé de chiffrement / kit d’urgence | Accès aux sauvegardes protégées | La sauvegarde existe, mais ne peut pas être ouverte |
| Définition de l’environnement d’exécution | Montages, périphériques, réseau, environnement | État correct, mais accès au service défaillant |
| Copie hors hôte + test de restauration | Défaillance de l’hôte et validité de la procédure | La récupération disparaît avec la production ou échoue au moment nécessaire |
Ne procédez à la mise à niveau que lorsque vous disposez de ces quatre éléments. Une copie manuelle de l’arborescence de configuration peut rester une couche supplémentaire, mais le plan de récupération principal doit reposer sur une sauvegarde prise en charge que vous pouvez déchiffrer et restaurer avec un environnement d’exécution documenté.
Produits recommandés
Assistance et conseils
Plus à lire
Faut-il sauvegarder Home Assistant en fonctionnement ou arrêter d’abord le service ?
Les sauvegardes intégrées de Home Assistant peuvent s’exécuter à chaud ; les simples copies du système de fichiers doivent arrêter ou mettre en veille...
Pourquoi un serveur Home Assistant chauffe-t-il ou est-il bruyant pendant les périodes d’inactivité ?
Corrélez les pics du ventilateur ou de température de Home Assistant avec Recorder, les sauvegardes, les intégrations et les tâches exécutées en parallèle avant...
Quand faut-il reconstruire Home Assistant plutôt que le réparer ?
Réparez d’abord la plus petite couche défaillante de Home Assistant, restaurez ensuite un état connu comme fiable et ne reconstruisez que lorsque la configuration...
