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

Restaurez Home Assistant avec un point de récupération antérieur à la mise à jour et compatible avec l’ancienne version de Core ; ne partez pas du principe que le lancement d’un ancien environnement d’exécution annule les migrations plus récentes de l’état persistant.

Le rollback le plus sûr commence avant toute première tentative de réparation : préservez l’état ayant échoué après la mise à jour, identifiez la dernière version et la dernière sauvegarde connues comme fonctionnelles, puis déterminez si l’incompatibilité vient de Core, d’une intégration personnalisée, d’un module complémentaire ou d’une base de données externe. Un rollback n’est réussi que lorsque l’ancien environnement peut lire l’état restauré et que les fonctions domestiques initiales refonctionnent. 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éservez l’état défaillant avant de tenter une rétrogradation

Ne remplacez pas l’unique copie de la configuration post-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 fonction précise qui ne fonctionne plus. Cette copie peut contenir de nouvelles modifications effectuées après la dernière bonne sauvegarde, ainsi que des éléments nécessaires pour comprendre ultérieurement l’incompatibilité.

Une régression de restauration survenue en 2026 a montré que même une restauration de sauvegarde apparemment réussie peut laisser l’environnement sur la mauvaise version lorsque le comportement du Supervisor environnant est défaillant. Le rapport consacré à la restauration de sauvegarde et au rollback de la version 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 fin.

Arrêtez de modifier la configuration jusqu’à ce que la procédure de récupération soit définie. Si la mise à jour a seulement cassé un composant personnalisé facultatif alors que le reste de Home Assistant est stable, le désactiver peut être plus sûr qu’effectuer un rollback complet. Si Core ne démarre pas, si la base de données ne se charge pas ou si des automatisations critiques sont inutilisables, passez à la procédure de récupération associant l’environnement d’exécution et l’état.

Choisissez un point de récupération antérieur à la version incompatible

Identifiez la dernière sauvegarde effectuée alors que l’ancienne version de Home Assistant fonctionnait correctement. Comparez son horodatage avec les éventuelles modifications importantes apportées aux automatisations, aux utilisateurs, aux tableaux de bord ou à l’historique que vous acceptez de perdre. Le point de récupération implique un compromis : il rétablit la compatibilité en faisant revenir l’état persistant à un moment antérieur.

Les conseils de ZimaSpace visant à créer un instantané des données des applications avant une mise à jour constituent la version préventive de la même règle : le rollback de l’environnement est plus propre lorsqu’une copie d’un état connu comme fonctionnel existe avant que le nouveau logiciel n’écrive pour la première fois dans les données de production.

Si aucune sauvegarde antérieure à la mise à jour n’est fiable, n’en fabriquez pas une en copiant la base de données déjà migrée et en l’associant à une ancienne image de Core. Préservez l’état actuel et étudiez une correction évolutive ou une reconstruction contrôlée. Un rollback sans copie d’état compatible peut transformer une seule fonctionnalité incompatible en problèmes affectant Recorder, l’historique ou le registre.

Restaurez l’environnement 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 souhaitée démarre réellement. Pour les installations en conteneur, revenir à l’image précédente ne constitue que la moitié de l’opération si la version plus récente a modifié les données persistantes ; restaurez également la copie de configuration correspondante, antérieure à la mise à jour.

Un problème de Home Assistant Core concernant le passage de 2025.4 à 2025.3 a documenté des défaillances de Recorder, de l’historique et d’intégrations associées lorsque l’ancien environnement rencontrait une structure de base de données plus récente. La réponse du responsable précise explicitement que le rollback 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 à des points compatibles que lorsque la sauvegarde de Home Assistant ne les gère pas. Ne rétrogradez pas aveuglément tous les conteneurs. MQTT, les proxys et les systèmes radio peuvent être sains et rester inchangés ; concentrez le rollback sur les composants dont la version ou le contrat d’état a réellement changé.

Featured

ZimaCube 2 NAS personnel Cloud à domicile

ZimaCube2

$799.00 - $2,499.00

Buy Now

Validez la défaillance initiale avant de réactiver les mises à jour automatiques

Après le rollback, vérifiez la version de Core en cours d’exécution, la connexion, Recorder et l’historique, les intégrations principales, les automatisations, les tableaux de bord et un appareil pour chaque protocole critique. Répétez l’action qui échouait avec la version incompatible et vérifiez qu’elle fonctionne désormais sans nouvelles erreurs. Redémarrez ensuite Home Assistant, puis redémarrez une fois l’hôte.

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

La récupération est validée lorsque l’ancienne version et l’état restauré restent stables en utilisation normale et après un redémarrage, et que la défaillance initiale a disparu. Demandez de l’aide lorsque la sauvegarde ne peut pas être restaurée, lorsque l’ancien environnement ne peut toujours pas lire son état ou lorsque des données critiques ne disposent d’aucun point de récupération compatible. À ce stade, une correction évolutive contrôlée ou une reconstruction est plus sûre que des tentatives répétées de rétrogradation.