Problème
Vous avez lancé une mise à jour de Home Assistant, et depuis, rien ne va. Selon les cas, la page ne s'ouvre plus du tout dans le navigateur, elle reste bloquée sur un message de démarrage, elle s'ouvre avec une notification de mode de récupération (recovery mode), ou tout fonctionne sauf une intégration qui reste en erreur et les automatisations qui en dépendent. La configuration n'est pas perdue pour autant : une mise à jour remplace le logiciel, pas vos réglages. Cette fiche vise Home Assistant OS, l'installation recommandée par le projet, où le système gère lui-même les mises à jour et les sauvegardes. Elle ne traite pas un service Linux qui ne repart pas après un redémarrage du serveur, qui relève d'une autre fiche.
Solution recommandée
Déterminer d'abord l'ampleur de la panne, puis appliquer le remède le plus léger qui suffit. Une seule intégration cassée se règle au niveau de cette intégration, souvent une intégration installée depuis la communauté qui n'a pas encore suivi la nouvelle version. Un système entier qui ne démarre plus se règle en revenant à la version précédente de Home Assistant Core, ce qui prend quelques minutes et garde tout ce qui a été fait depuis la dernière sauvegarde. La restauration d'une sauvegarde ne vient qu'en dernier, parce qu'elle remet l'ensemble du système à l'état du jour où elle a été faite et efface ce qui a changé depuis. La clé de toute la démarche est de pouvoir agir sans l'interface web : par la console de la machine (clavier et écran branchés) ou par l'accès en SSH, où la commande « ha » pilote Home Assistant.
Matériel & outils
Un navigateur sur le réseau de la maison, l'adresse de la machine Home Assistant (port 8123 pour l'interface, port 4357 pour la page d'état du système, l'observer), un clavier et un écran à brancher sur la machine pour la console, ou l'app de terminal SSH si elle est déjà installée, les notes de version publiées sur le site de Home Assistant, la sauvegarde la plus récente et sa clé de chiffrement, conservée dans le kit d'urgence téléchargé lors de la mise en place des sauvegardes
Étapes
1. Attendre. Après une mise à jour, le premier démarrage peut prendre de longues minutes, davantage sur un Raspberry Pi ou une carte SD lente : Home Assistant met à jour sa base de données et réinstalle les dépendances des intégrations. Laisser au moins quinze minutes avant de conclure à une panne, sans couper le courant ni redémarrer entre-temps, ce qui peut interrompre une migration en cours 2. Si l'interface ne répond toujours pas, ouvrir dans le navigateur l'adresse de la machine suivie du port 4357. Cette page d'état, l'observer, est servie à part de Home Assistant. Si elle répond, la machine et le réseau vont bien, et c'est Home Assistant lui-même qui ne démarre pas. Si elle ne répond pas non plus, le problème est la machine ou le réseau, hors du champ de cette fiche 3. Prendre la main sans l'interface web : brancher un clavier et un écran sur la machine pour obtenir la console de Home Assistant OS, ou se connecter par SSH si l'app de terminal était installée. Taper « ha core info » pour lire la version installée, puis « ha core logs » pour lire le journal du démarrage. Chercher les lignes marquées ERROR ou CRITICAL : elles nomment presque toujours l'intégration ou le fichier en cause 4. Si l'interface s'ouvre mais affiche le mode de récupération, ne rien supprimer : ce mode charge un Home Assistant minimal pour vous permettre de réparer, sans toucher à votre configuration. Ouvrir Paramètres, Système, Journaux pour lire l'erreur qui a empêché le démarrage normal. Une erreur de syntaxe dans un fichier de configuration modifié à la main, ou une intégration de base qui ne charge plus, en est la cause habituelle 5. Si une seule intégration est cassée ou si le journal accuse une intégration installée depuis la communauté, redémarrer en mode sans échec (safe mode) : depuis le menu de redémarrage des paramètres système, ou par la commande « ha core restart --safe-mode ». Ce mode démarre Home Assistant sans aucune intégration personnalisée, carte personnalisée ni thème, et ne dure que jusqu'au prochain redémarrage. Si tout remarche ainsi, le fautif est une intégration personnalisée : chercher sa mise à jour, ou la désactiver le temps que son auteur suive la nouvelle version 6. Avant de revenir en arrière, lire les notes de version de la version installée, rubrique des changements incompatibles (breaking changes). Il arrive qu'une intégration demande simplement une action de votre part, une option renommée ou une reconnexion, et que le retour en arrière soit inutile 7. Si tout le système reste bloqué, revenir à la version précédente de Home Assistant Core depuis la console : « ha core update --version » suivi du numéro de la version qui fonctionnait, par exemple 2026.10.3. Ce numéro figure dans les notes de version, et souvent dans le nom de la sauvegarde faite avant la mise à jour. Attendre la fin du démarrage, puis vérifier que les automatisations et les intégrations sont revenues 8. Si la version précédente démarre mais que des données semblent incohérentes, ou si le retour de version échoue, restaurer la sauvegarde faite juste avant la mise à jour. Par la console : « ha backups list » pour lister les sauvegardes avec leur date, puis « ha backups restore » suivi de l'identifiant de la bonne. Par l'interface, si elle s'ouvre : Paramètres, Système, Sauvegardes, afficher toutes les sauvegardes, choisir la plus récente d'avant la mise à jour, cocher ce qui doit être restauré. La clé de chiffrement du kit d'urgence peut être demandée 9. En dernier recours, si la machine elle-même est inutilisable, réinstaller Home Assistant OS et restaurer la sauvegarde pendant l'assistant de première installation, qui propose de repartir d'une sauvegarde 10. Une fois revenu à un système stable, ne pas relancer la même mise à jour aussitôt. Attendre la version corrective suivante, publiée en général dans la semaine, et activer dans les réglages de sauvegarde l'option qui crée une sauvegarde avant chaque mise à jour, pour que l'étape 8 soit toujours possible
Coût estimé
0 €. Tout se fait avec Home Assistant et ses commandes intégrées. Le seul achat éventuel est un câble pour brancher un écran sur la machine, ou un clavier si la maison n'en a plus.
Limites
Ne couvre pas la réparation du système d'exploitation de la machine elle-même, une carte SD ou un disque en fin de vie, ni une machine qui ne s'allume plus. Pour une installation en conteneur (Home Assistant Container), la commande « ha » n'existe pas : le principe reste le même, revenir à l'image de la version précédente et relancer le conteneur, mais le détail dépend de votre outil. Ne traite pas le cas d'une intégration personnalisée abandonnée par son auteur, qui ne fonctionnera plus sur les versions récentes. Un retour de version n'annule pas les changements que la nouvelle version a déjà appliqués aux données : si des incohérences apparaissent, seule la sauvegarde d'avant la mise à jour les efface. Les noms de menus cités correspondent à Home Assistant en octobre 2026 et peuvent bouger d'une version mensuelle à l'autre.
Erreurs fréquentes
Restaurer d'emblée une sauvegarde complète, parfois vieille de plusieurs semaines, alors qu'un retour à la version précédente suffisait : on efface les automatisations, appareils et historiques ajoutés depuis, pour une panne qui se réglait en une commande. Couper le courant de la machine parce que le démarrage semble trop long, et interrompre une migration de la base de données en cours. Supprimer une intégration en erreur après la mise à jour, puis devoir reconfigurer ses appareils, alors qu'une version corrigée de l'intégration ou un passage en mode sans échec suffisait à trouver le fautif. Découvrir le jour de la panne que la clé de chiffrement des sauvegardes n'a jamais été conservée, ce qui rend toutes les sauvegardes inutilisables. Appliquer chaque mise à jour le jour de sa sortie sans lire la rubrique des changements incompatibles des notes de version.
Alternatives
Pour ne plus subir ce scénario : attendre quelques jours après la sortie d'une version mensuelle, le temps que la première version corrective paraisse, lire les notes de version avant de cliquer, et garder activée la sauvegarde automatique avant mise à jour, dont une copie part hors de la machine. Limiter les intégrations installées depuis la communauté à celles qui servent vraiment : ce sont elles qui cassent le plus souvent après une mise à jour. Sur une installation qui compte, tester d'abord la nouvelle version sur une seconde machine ou une machine virtuelle restaurée depuis la même sauvegarde.
Besoin d'un accompagnement personnalisé ?
Cours 1:1, conseil de solution, ou simplement une question précise - contacte-moi directement.