Cómo restaurar Home Assistant después de una actualización fallida del contenedor
Una actualización fallida del contenedor de Home Assistant normalmente debe tratarse como un problema de reemplazo del entorno de ejecución, no como una razón para crear una instalación nueva. Si el directorio /config montado desde el host está intacto, la vía de recuperación más segura es conservar ese estado, verificar la asignación del volumen, iniciar una imagen conocida y funcional, y probar la instalación existente antes de restaurar una copia de seguridad anterior.
El movimiento peligroso es permitir que un contenedor nuevo se inicie con una ruta del host incorrecta o vacía. Home Assistant puede mostrar entonces el proceso de configuración inicial como si la configuración hubiera desaparecido, mientras el estado original sigue existiendo en otra ubicación del disco. Primero congela los cambios, identifica el directorio de configuración autorizado y no elimines el contenedor ni el directorio antiguos hasta que la instancia recuperada supere las pruebas.
Detén las nuevas escrituras y encuentra la ruta real de /config
Detén el contenedor fallido e inspecciona la definición del entorno de ejecución que lo creó. Confirma qué directorio del host o volumen con nombre está asignado a /config y, después, inspecciona esa ubicación en busca de tus archivos YAML, .storage, componentes personalizados, secretos y la base de datos.
Un caso de recuperación de la comunidad tras una actualización de Docker descubrió que una instancia de Home Assistant “completamente nueva” se debía en realidad a que el contenedor apuntaba a la carpeta de configuración incorrecta. Los datos persistentes no se habían borrado; el entorno de ejecución de reemplazo simplemente no los montaba correctamente.
Copia o crea una instantánea del directorio de configuración actual antes de cambiar propietarios, rutas o archivos de la base de datos. Incluso un estado parcialmente dañado es una evidencia valiosa y puede contener automatizaciones o credenciales más recientes que la última copia de seguridad.
Recrea el entorno de ejecución sin recrear la instalación
Usa el mismo modo de red, zona horaria, asignaciones de dispositivos, acceso a radios USB, privilegios o capacidades, y montaje de /config del host que utilizaba el contenedor funcional antes de la actualización. La imagen se puede reemplazar; esas entradas del entorno de ejecución y los datos persistentes determinan si el servicio vuelve como la misma instancia de Home Assistant.
La persistencia del contenedor depende del montaje del host, no del sistema de archivos del contenedor. Un ejemplo de Home Assistant Container monta un volumen persistente del host directamente en /config, por lo que recrear el entorno de ejecución no recrea la configuración del hogar. Si esa asignación cambia durante una actualización, un contenedor de reemplazo puede parecer nuevo mientras el estado original sigue existiendo en otra ubicación.
No copies el sistema de archivos del contenedor antiguo a la imagen nueva. Recrea el despliegue a partir de una definición documentada de Compose o de ejecución y vuelve a conectar explícitamente el estado persistente.
Revierte la imagen antes de restaurar un estado anterior
Si el montaje de configuración es correcto, pero la nueva versión de Home Assistant no se inicia o rompe una integración crítica, prueba la imagen anterior conocida y funcional con el mismo /config conservado. Así podrás distinguir entre “el nuevo entorno de ejecución es incompatible con el estado actual” y “el propio estado está dañado”.
El flujo de trabajo actual de Home Assistant Container separa explícitamente la imagen del estado persistente: haz primero una copia de seguridad, descarga la imagen objetivo, recrea el contenedor y usa una etiqueta de imagen antigua específica cuando sea necesario degradar la versión. Ese es el límite de recuperación que debes conservar: reemplazar el entorno de ejecución manteniendo intacta la ruta de configuración autorizada.
Al volver a una versión anterior, recuerda que algunas actualizaciones migran estructuras de datos. Usa una copia de seguridad creada antes de la migración si la versión antigua no puede leer de forma segura un estado que ya fue actualizado por la versión nueva. No alternes repetidamente entre versiones utilizando la única copia de los datos persistentes.
Restaura una copia de seguridad solo cuando el estado actual no sea fiable
Usa una copia de seguridad cuando la configuración persistente falte, esté dañada, se haya sobrescrito parcialmente o ya no sea compatible con la versión que puedes ejecutar de forma segura. Cuando sea posible, restaúrala en un destino aislado o limpio para poder comparar el estado recuperado con la copia dañada.
Conserva fuera del host fallido la contraseña de cifrado o el kit de emergencia necesarios para abrir la copia de seguridad. Una copia que solo existe en el mismo disco o que no puede descifrarse no ofrece una vía de recuperación.
El ejemplo de ZimaSpace sobre separar la recuperación de Home Assistant del propio host de almacenamiento refuerza la misma regla: el estado de la aplicación necesita una vía de restauración independiente, no solo un disco activo duplicado.
Valida el contenedor recuperado antes de eliminar nada
- Confirma que estén presentes los usuarios, paneles, integraciones, automatizaciones, asistentes y áreas esperados.
- Verifica una ruta de dispositivo local y una ruta basada en radio si utilizas Zigbee, Z-Wave o Bluetooth.
- Comprueba si hay errores de base de datos o migración en Recorder.
- Reinicia el contenedor recuperado y confirma que vuelve a aparecer el mismo estado.
- Conserva la etiqueta de la imagen antigua, una copia de la configuración y la última copia de seguridad conocida y funcional hasta que este segundo arranque supere las pruebas.
Si la imagen antigua funciona con la configuración original, la actualización fallida era principalmente un problema de versión o del entorno de ejecución. Si todas las imágenes fallan con el mismo estado, pasa a reparar la configuración o restaurar una copia de seguridad. Si un contenedor limpio solo funciona con un /config vacío, no aceptes la configuración inicial como “solución” hasta entender qué elemento del estado persistente impide la recuperación.
Preguntas frecuentes
¿Debo eliminar el contenedor fallido de Home Assistant antes de solucionar el problema?
No. Deténlo primero y conserva su definición del entorno de ejecución y la ruta de configuración montada. Puedes crear un contenedor de reemplazo sin eliminar el fallido, lo que mantiene disponible la información necesaria para volver atrás mientras compruebas el nuevo entorno de ejecución.
¿Por qué Home Assistant muestra la configuración inicial después de una actualización?
La razón más habitual y específica de los contenedores es que el entorno de ejecución de reemplazo no está viendo la ruta original de /config. Verifica el montaje del host antes de asumir que la configuración se ha borrado o de restaurar una copia de seguridad anterior sobre un estado más reciente.
Productos recomendados
Soporte y Consejos
Más para leer
¿Deberías hacer una copia de seguridad de Home Assistant en ejecución o detener primero el servicio?
Las copias de seguridad integradas de Home Assistant pueden ejecutarse en vivo; las copias simples del sistema de archivos deben detener o poner en...
¿Por qué un servidor de Home Assistant se calienta o hace ruido durante las horas de inactividad?
Correlaciona los picos de ventilación o temperatura de Home Assistant con Recorder, las copias de seguridad, las integraciones y las tareas alojadas conjuntamente antes...
¿Cuándo deberías reconstruir Home Assistant en lugar de repararlo?
Repara primero la capa más pequeña de Home Assistant que haya fallado, restaura después un estado conocido y funcional, y reconstruye solo cuando no...
