Comment revenir en toute sécurité à une version antérieure de Home Assistant après une mise à jour incompatible

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Rétrogradez Home Assistant à l’aide d’un point de restauration antérieur à la mise à jour, correspondant à l’ancienne version de Core ; ne supposez pas que le lancement d’un ancien environnement d’exécution annule les migrations plus récentes de l’état persistant.

La restauration la plus sûre commence avant la première tentative de réparation : préservez l’état défaillant après la mise à jour, identifiez la dernière version et la dernière sauvegarde dont le bon fonctionnement est connu, puis déterminez si l’incompatibilité concerne Core, une intégration personnalisée, un module complémentaire ou une base de données externe. Une restauration n’est réussie que lorsque l’environnement d’exécution précédent peut lire l’état restauré et que les fonctions essentielles du foyer fonctionnent à nouveau. Le changement de version et la restauration des données constituent une seule opération de récupération, et non deux actions indépendantes.

Préserver l’état défaillant avant de tenter une rétrogradation

N’écrasez pas la seule copie de la configuration après la mise à jour pendant vos essais. Enregistrez la configuration actuelle, les journaux, les numéros de version, l’emplacement de la base de données et la fonctionnalité précise qui ne fonctionne plus. Cette copie peut contenir des modifications récentes absentes de la dernière bonne sauvegarde, ainsi que des éléments utiles pour comprendre ultérieurement l’incompatibilité.

Une régression de la restauration en 2026 a montré que même une restauration de sauvegarde apparemment réussie peut laisser l’environnement d’exécution sur la mauvaise version si le fonctionnement du Supervisor est défectueux. Le signalement concernant la restauration d’une sauvegarde et le retour à une version précédente de Core rappelle qu’il est utile de vérifier la version réelle après la restauration plutôt que de se fier au message de confirmation.

Cessez de modifier la configuration tant que la procédure de récupération n’est pas établie. Si la mise à jour a rendu inutilisable un composant personnalisé facultatif alors que le reste de Home Assistant fonctionne correctement, le désactiver peut être plus prudent qu’effectuer une restauration complète. Si Core ne démarre pas, si la base de données ne se charge pas ou si les automatisations critiques sont inutilisables, optez pour la procédure de récupération combinant l’environnement d’exécution et l’état.

Choisir un point de restauration antérieur à la version incompatible

Identifiez la dernière sauvegarde effectuée lorsque l’ancienne version de Home Assistant fonctionnait correctement. Vérifiez son horodatage par rapport aux changements importants apportés aux automatisations, aux utilisateurs, au tableau de bord ou à l’historique que vous acceptez de perdre. Le point de restauration implique un compromis : il rétablit la compatibilité en ramenant l’état persistant à un état antérieur.

Les recommandations de ZimaSpace pour sauvegarder les données des applications avant une mise à jour sont une application préventive de la même règle : le retour à une version antérieure est plus simple lorsque l’on dispose d’une copie d’un état connu comme fonctionnel, créée avant que le nouveau logiciel ne modifie les données en production.

En l’absence d’une sauvegarde fiable antérieure à la mise à jour, n’en fabriquez pas une en copiant la base de données déjà migrée pour l’associer à une ancienne image Core. Préservez l’état actuel et recherchez un correctif en mettant à jour ou une reconstruction contrôlée. Une rétrogradation sans copie d’état compatible peut transformer l’incompatibilité d’une seule fonctionnalité en défaillances de Recorder, de l’historique ou des registres.

Restaurer l’environnement d’exécution et l’état persistant comme un ensemble cohérent

Pour Home Assistant OS ou une installation gérée, utilisez la procédure de restauration prise en charge qui rétablit le point de récupération sélectionné, puis vérifiez que la version de Core prévue démarre bien. Pour les installations Container, revenir à l’image précédente ne suffit que si la nouvelle version a modifié les données persistantes ; restaurez également la copie de configuration correspondante, créée avant la mise à jour.

Un problème Home Assistant Core concernant la rétrogradation de 2025.4 vers 2025.3 a documenté des défaillances de Recorder, de l’historique et des intégrations associées lorsque l’ancien environnement d’exécution rencontrait une structure de base de données plus récente. La réponse du responsable indique explicitement que la rétrogradation repose sur la restauration d’une sauvegarde, et non sur une procédure de rétrogradation de la base de données sur place.

Ne restaurez les bases de données externes et les services dépendants vers des versions compatibles que si la sauvegarde Home Assistant ne les inclut pas. Ne revenez pas aveuglément en arrière sur toutes les versions des conteneurs. MQTT, les proxys et les radios peuvent fonctionner correctement et rester inchangés ; concentrez la rétrogradation sur les composants dont la version ou le format d’état a réellement changé.

Valider le problème initial avant de réactiver les mises à jour automatiques

Après la rétrogradation, vérifiez la version de Core en cours d’exécution, la connexion, Recorder/l’historique, les intégrations clés, les automatisations, les tableaux de bord et un appareil pour chaque protocole critique. Réessayez l’action qui a échoué avec la version incompatible et vérifiez qu’elle fonctionne désormais sans générer de nouvelles erreurs. Redémarrez ensuite Home Assistant, puis redémarrez l’hôte une fois.

Conservez la copie de l’état défaillant et les notes de mise à jour jusqu’à ce que la prochaine version ou le correctif ait été testé. Si une intégration personnalisée est à l’origine de l’incompatibilité, vérifiez les versions prises en charge avant la prochaine mise à jour de Core. Si la restauration échoue, n’alternez pas sans cesse entre les versions sur la même base de données modifiable ; revenez au point de récupération propre ou procédez à une reconstruction avec restauration sélective.

Considérez l’opération comme réussie si l’ancienne version et l’état restauré restent stables en utilisation normale et après le redémarrage, et si le problème initial a disparu. Escaladez si la sauvegarde ne peut pas être restaurée, si l’ancien environnement d’exécution ne peut toujours pas lire son état ou si des données critiques ne disposent d’aucun point de récupération compatible. Dans ce cas, une correction contrôlée en mettant à jour ou une reconstruction est plus sûre que des tentatives répétées de rétrogradation.

Assistance et conseils

À lire aussi

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.