Cómo revertir Home Assistant de forma segura después de una versión incompatible

Revierte Home Assistant con un punto de recuperación previo a la actualización que coincida con la versión anterior de Core; no supongas que iniciar un runtime antiguo revierte las migraciones más recientes del estado persistente.

La reversión más segura comienza antes del primer intento de reparación: conserva el estado posterior a la actualización fallida, identifica la última versión y copia de seguridad conocidas como funcionales, y decide si la incompatibilidad corresponde a Core, una integración personalizada, un complemento o una base de datos externa. Una reversión solo tiene éxito cuando el runtime anterior puede leer el estado restaurado y las funciones originales del hogar vuelven a funcionar. Cambiar la versión y revertir los datos son una sola operación de recuperación, no dos botones sin relación.

Conserva el estado fallido antes de intentar degradar

No sobrescribas la única copia de la configuración posterior a la actualización mientras haces pruebas. Guarda la configuración actual, los registros, los números de versión, la ubicación de la base de datos y la función exacta que dejó de funcionar. Esa copia puede contener cambios nuevos realizados después de la última copia de seguridad funcional y pruebas necesarias para comprender la incompatibilidad más adelante.

Una regresión de restauración de 2026 demostró que incluso una restauración de copia de seguridad aparentemente exitosa puede dejar el runtime en la versión equivocada cuando el comportamiento del Supervisor circundante presenta errores. El informe sobre la restauración de copias de seguridad y la reversión de la versión de Core es una buena razón para verificar la versión real después de restaurar, en lugar de confiar en el mensaje de finalización.

Deja de realizar cambios de configuración hasta conocer la ruta de recuperación. Si la actualización rompió un componente personalizado opcional mientras el resto de Home Assistant permanece estable, desactivar ese componente puede ser más seguro que hacer una reversión completa. Si Core no puede iniciarse, la base de datos no se carga o las automatizaciones críticas no se pueden utilizar, pasa a la ruta de recuperación emparejada del runtime y el estado.

Elige un punto de recuperación anterior a la versión incompatible

Identifica la última copia de seguridad realizada mientras la versión anterior de Home Assistant funcionaba correctamente. Comprueba su fecha y hora frente a cualquier cambio importante en automatizaciones, usuarios, paneles o historial que estés dispuesto a perder. El punto de recuperación implica una decisión: restaura la compatibilidad retrocediendo el estado persistente en el tiempo.

La recomendación de ZimaSpace de crear una instantánea de los datos de las aplicaciones antes de una actualización es la versión preventiva de la misma regla: la reversión del runtime es más limpia cuando existe una copia de un estado conocido como funcional anterior al momento en que el software nuevo escribe por primera vez en los datos de producción.

Si no existe una copia de seguridad previa a la actualización en la que puedas confiar, no intentes crearla copiando la base de datos ya migrada y emparejándola con una imagen antigua de Core. Conserva el estado actual e investiga una solución hacia delante o una reconstrucción controlada. Una reversión sin una copia de estado compatible puede convertir una función incompatible en fallos del registrador, el historial o el registro de entidades.

Restaura el runtime y el estado persistente como un par compatible

En Home Assistant OS o en una instalación administrada, utiliza la ruta de restauración compatible que recupere el punto de recuperación seleccionado y verifica que se inicie realmente la versión de Core prevista. En instalaciones mediante contenedores, revertir la imagen solo es la mitad de la operación si la versión más reciente modificó los datos persistentes; restaura también la copia de configuración correspondiente anterior a la actualización.

Un problema de Home Assistant Core sobre la degradación de 2025.4 a 2025.3 documentó fallos del registrador, el historial y las integraciones relacionadas cuando el runtime anterior encontraba una estructura de base de datos más reciente. La respuesta del responsable indica explícitamente que la reversión depende de restaurar una copia de seguridad, no de una ruta para degradar la base de datos directamente.

Restaura las bases de datos externas y los servicios dependientes a puntos compatibles solo cuando la copia de seguridad de Home Assistant no los incluya. No reviertas todos los contenedores a ciegas. MQTT, los proxies y las radios pueden estar en buen estado y permanecer sin cambios; concentra la reversión en los componentes cuyo contrato de versión o estado haya cambiado realmente.

Featured

ZimaCube 2 NAS personal en la nube para el hogar

ZimaCube2

$799.00 - $2,499.00

Buy Now

Valida el fallo original antes de volver a activar las actualizaciones automáticas

Después de la reversión, confirma la versión de Core en ejecución, el inicio de sesión, el registrador y el historial, las integraciones clave, las automatizaciones, los paneles y un dispositivo de cada protocolo crítico. Repite la acción que falló en la versión incompatible y verifica que ahora funcione sin errores nuevos. Después, reinicia Home Assistant y reinicia el host una vez.

Conserva la copia del estado fallido y las notas de actualización hasta haber probado la siguiente versión o solución. Si una integración personalizada causó la incompatibilidad, comprueba sus versiones compatibles antes de la próxima actualización de Core. Si la propia reversión falla, no alternes versiones repetidamente contra la misma base de datos mutable; vuelve al punto de recuperación limpio o pasa a una reconstrucción con restauración selectiva.

La recuperación se considera correcta cuando la versión anterior y el estado restaurado permanecen estables durante el uso normal y tras reiniciar, y el fallo original ha desaparecido. Escala el caso cuando la copia de seguridad no se puede restaurar, el runtime anterior sigue sin poder leer su estado o los datos críticos no tienen un punto de recuperación compatible. En ese límite, una solución controlada hacia delante o una reconstrucción es más segura que repetir los intentos de degradación.