Cómo trasladar los datos de Home Assistant sin perder usuarios, historial ni configuraciones
Mueve los datos de Home Assistant conservando el estado completo de la aplicación y manteniendo la instancia antigua intacta hasta que la sustituta supere una validación completa.
Los usuarios y la configuración no se limitan a los archivos YAML visibles, y el historial no se recrea copiando un panel. Una migración debe conservar el directorio de configuración de Home Assistant o una copia de seguridad compatible, la base de datos de Recorder cuando el historial sea importante, el almacenamiento oculto, los secretos, los componentes personalizados y las asignaciones de dispositivos y red específicas del entorno de ejecución. La secuencia más segura es inventariar, realizar una copia coherente, iniciar de forma aislada, validar y, después, retirar el origen.
Inventaria el estado persistente y las dependencias externas antes del traslado
En una instalación mediante contenedor, trata todo el directorio de configuración de Home Assistant montado como la unidad principal de recuperación, en lugar de seleccionar unos pocos archivos conocidos. El estado oculto de .storage, los datos de autenticación, los registros de integraciones, los paneles, las automatizaciones y la base de datos predeterminada de Recorder pueden encontrarse bajo esa ruta. MariaDB externa, MQTT, puertas de enlace Zigbee, almacenes de secretos o montajes NAS deben enumerarse por separado.
Una guía para trasladar contenedores de Home Assistant muestra por qué es más seguro realizar un traslado de todo el directorio de configuración que reconstruir el estado archivo por archivo, y destaca la importancia de detener el contenedor antiguo antes de hacer una copia directa del sistema de archivos.
Crea un manifiesto con la ruta de origen, la ruta de destino, el propietario UID/GID, la ubicación de la base de datos, los dispositivos USB o serie, el modo de red, los puertos publicados, los servicios externos y la versión actual de Home Assistant. Si alguna dependencia no está documentada, no elimines la instancia antigua. La migración no estará lista hasta que el nuevo host pueda reproducir esa dependencia a partir de información escrita.
Crea un punto de reversión coherente antes de copiar los datos
Utiliza la copia de seguridad integrada u otro método compatible con la aplicación cuando tu instalación lo admita. Si vas a realizar una copia directa de un contenedor, detén Home Assistant antes de copiar la base de datos de configuración activa y los archivos relacionados. Una copia en caliente normal puede capturar archivos de la aplicación en momentos distintos, justo lo contrario de una migración controlada.
La renovación del sistema de copias de seguridad de Home Assistant amplió la compatibilidad de restauración entre métodos de instalación, lo que convierte una copia de seguridad compatible en un límite sólido de portabilidad al cambiar el entorno de ejecución. La lección práctica de la restauración de copias entre instalaciones es que el nuevo entorno de ejecución puede cambiar, mientras que el estado de la aplicación sigue siendo el límite de continuidad.
Conserva dos copias: un punto de recuperación previo al traslado que no se toque y una copia de trabajo para la migración. No permitas que la nueva instancia de Home Assistant se inicie usando la única copia válida del origen. Si el destino realiza una migración o escribe un nuevo estado de registro, aún debes disponer de una ruta limpia de vuelta a la versión y al host antiguos.
Recrea por separado las asignaciones de hardware y red específicas del entorno
Los datos de la aplicación no recrean automáticamente las rutas de los dispositivos del host. Los coordinadores USB de Zigbee o Z-Wave pueden aparecer con otro nombre de dispositivo, el acceso a Bluetooth puede ser diferente, la red del host puede cambiar el descubrimiento y las bases de datos externas o los intermediarios MQTT pueden resolverse mediante otras direcciones. Reconstruye explícitamente esas interfaces antes de interpretar una integración no disponible como una pérdida de datos.
Una guía independiente sobre la migración de contenedores a HAOS muestra que restaurar el estado de Home Assistant Core no recrea automáticamente servicios auxiliares como MQTT, Zigbee2MQTT o Node-RED. Su secuencia de migración con reasignación de servicios auxiliares también verifica la continuidad del historial de Recorder, el acceso al coordinador USB y un conjunto de servicios antiguo detenido pero intacto como ruta de reversión.
Inicia el destino mediante una ruta LAN controlada y evita ejecutar ambas instancias con las mismas radios, webhooks, cuentas en la nube o automatizaciones, salvo que las hayas aislado deliberadamente. Dos instancias activas de Home Assistant pueden enviar acciones duplicadas o competir por el mismo coordinador, haciendo que una migración de datos correcta parezca defectuosa.
Valida los usuarios, el historial, la configuración y el control de dispositivos antes del cambio
Inicia sesión con una cuenta existente que no sea de administrador, confirma una cuenta de administrador, abre gráficos históricos anteriores al traslado, inspecciona las integraciones, activa automatizaciones representativas y verifica un dispositivo de cada protocolo importante. Después, reinicia Home Assistant y reinicia el host de destino para demostrar que el estado recuperado sobrevive a los eventos normales del ciclo de vida.
La explicación relacionada de ZimaSpace sobre los roles de datos persistentes de Home Assistant ofrece un límite de recuperación útil: la identidad, la configuración y el historial duraderos deben tratarse de forma distinta a la caché o los archivos temporales durante un traslado.
Cambia el DNS, el proxy o el acceso remoto solo después de superar las pruebas locales. Mantén el host antiguo apagado, pero recuperable, durante al menos un ciclo de uso normal. Retíralo únicamente cuando los usuarios, el historial, la configuración, las automatizaciones, las radios, los servicios externos, la creación de copias de seguridad y un reinicio funcionen como se espera; la carga correcta del primer panel no basta para justificar la eliminación de la ruta de reversión.
Productos recomendados
Soporte y Consejos
Más para leer
Cómo optimizar las conexiones de la base de datos de Home Assistant para contenedores simultáneos
Ajusta una base de datos externa de Recorder a partir de las conexiones activas y la latencia medidas, no aumentando el máximo de conexiones...
Cómo evitar trabajos o importaciones duplicados en Home Assistant
Usa trazas y claves de operación únicas para que las automatizaciones y las importaciones se puedan reintentar de forma segura sin generar acciones ni...
Cómo reparar Home Assistant después de que se llene el volumen de su base de datos
Recupera un volumen de Recorder completamente lleno sin eliminar primero las evidencias, luego reduce el crecimiento y demuestra que el historial y las automatizaciones...
