Cómo evitar la pérdida de la configuración de Home Assistant durante las actualizaciones
Evita perder la configuración de Home Assistant usando el sistema de copias de seguridad integrado como vía principal de recuperación y tratando el entorno de ejecución como reemplazable. La versión de Home Assistant, la imagen del contenedor o el host pueden cambiar; la copia de seguridad, la clave de cifrado, la definición del entorno de ejecución y cualquier dependencia externa deben seguir disponibles cuando la máquina original ya no esté.
Las copias de seguridad modernas de Home Assistant funcionan con distintos tipos de instalación, incluido Container. Conserva una copia manual independiente del árbol de configuración cuando aporte valor, pero no bases todo el plan de actualización en copiar archivos manualmente mientras ignoras el flujo de copia de seguridad y restauración compatible.
Empieza con una copia de seguridad integrada, no con una carpeta YAML copiada manualmente
No reduzcas la “configuración” a configuration.yaml. El sistema de copias de seguridad compatible con Home Assistant captura el estado de la aplicación necesario para la recuperación, incluidos la configuración y el contenido de la base de datos, mientras que los flujos de copia más recientes también admiten automatización, retención y ubicaciones externas.
La renovación del sistema de copias de seguridad introducida en 2025 añadió copias de seguridad cifradas automáticas, controles de retención y ubicaciones externas para copias de seguridad. Esto convierte la copia integrada en el primer recurso de recuperación que debes verificar antes de una actualización, en lugar de depender de una copia manual incompleta.
Aun así, registra la raíz de configuración, la base de datos utilizada, las referencias a secretos, los componentes personalizados, el material SSL y cualquier archivo o servicio externo que requiera una integración. Una copia de seguridad puede restaurar el estado de Home Assistant sin documentar automáticamente cada dispositivo USB, ruta de red, host de base de datos o parámetro del contenedor que lo rodea.
Mantén explícitos la persistencia del contenedor y los ajustes del entorno de ejecución
En Docker, confirma el montaje enlazado o el volumen propietario de /config y conserva la definición de Compose o de ejecución que recrea el modo de red, las asignaciones de dispositivos, la zona horaria, los privilegios y los servicios externos. El sistema de archivos del contenedor debe seguir siendo desechable.
Una conversación sobre copias de seguridad de Home Assistant en Docker muestra claramente el modo de fallo: cuando los usuarios mapean solo un archivo en lugar del directorio de configuración completo, el estado importante puede quedar atrapado dentro del contenedor y desaparecer cuando se reemplaza ese entorno de ejecución.
Verifica el montaje del host antes de actualizar y conserva la definición del entorno de ejecución junto a la copia de seguridad. La recuperación es mucho más rápida cuando tanto el estado de la aplicación como las instrucciones necesarias para exponer radios, puertos, redes y almacenamiento ya están identificados.
Mueve al menos una copia de seguridad cifrada fuera del host
Una copia de seguridad en el mismo SSD protege frente a algunos errores de configuración, pero no frente a la pérdida del host, la corrupción del sistema de archivos, el robo o el fallo del dispositivo de almacenamiento. Conserva al menos una copia de recuperación en un NAS, otro equipo o una ubicación remota de copias de seguridad cuyo acceso no dependa del host de Home Assistant averiado.
Guarda también la clave de cifrado de la copia de seguridad o el kit de emergencia fuera de Home Assistant. Home Assistant 2026.4 trasladó las nuevas copias cifradas al formato SecureTar v3 auditado, con un cifrado moderno más sólido, lo que mejora la seguridad de las copias, pero convierte la custodia de la clave en una parte explícita de la capacidad de recuperación.
Versiona las copias de seguridad en lugar de sobrescribir siempre el mismo archivo. Una actualización puede revelar un problema días después, y el punto de recuperación más reciente ya puede contener el estado migrado o dañado del que intentas escapar.
La copia de seguridad aún no sustituye la definición del entorno de ejecución
La configuración por sí sola puede no restaurar radios USB, redes del host, zona horaria, acceso directo a dispositivos, servicios de base de datos, MQTT o relaciones con el proxy inverso. Conserva el archivo de Compose, la política de versiones de la imagen, las variables de entorno, las rutas del host, las asignaciones de dispositivos y las dependencias de servicios necesarias para recrear el entorno de ejecución.
No guardes secretos en texto plano en un repositorio público solo para versionar el archivo de Compose. Mantén los valores secretos en una ubicación protegida y documenta únicamente de dónde los recupera el proceso de recuperación.
La guía de implementación de Home Assistant en ZimaBoard de ZimaSpace ofrece un contexto útil para separar la plataforma de servidor doméstico del estado de la aplicación que debe sobrevivir a futuros cambios de implementación.
Haz una prueba de restauración antes de que la actualización se convierta en una emergencia
Una copia de seguridad no está validada solo porque exista el archivo. Restáurala en un destino aislado o en un contenedor temporal, vuelve a conectar dispositivos y rutas representativos cuando sea práctico y confirma que el sistema regresa con los usuarios, paneles, integraciones, automatizaciones, asistentes y el estado esperado.
Usa la prueba para descubrir contraseñas que faltan, rutas antiguas del host, asignaciones de dispositivos no documentadas y bases de datos demasiado grandes mientras el sistema de producción aún funciona. Registra los pasos de restauración después de completar la prueba correctamente; la memoria no es un plan de recuperación.
Justo antes de actualizar, crea un nuevo punto de recuperación, registra la versión actual de Home Assistant y la imagen del contenedor, y revisa los cambios de la versión que afectan a tus integraciones. Mantén disponible el entorno de ejecución anterior hasta que la instancia actualizada supere tanto un periodo normal de uso como un reinicio.
Usa una comprobación de seguridad de actualización en cuatro partes
| Recurso de recuperación | Qué protege | Fallo si falta |
|---|---|---|
| Copia de seguridad integrada | La configuración de Home Assistant y el estado recuperable de la aplicación | No hay un punto de restauración compatible |
| Clave de cifrado / kit de emergencia | El acceso a las copias de seguridad protegidas | La copia existe, pero no se puede abrir |
| Definición del entorno de ejecución | Montajes, dispositivos, red y entorno | El estado es correcto, pero el acceso al servicio no funciona |
| Copia fuera del host + prueba de restauración | El fallo del host y la validez del procedimiento | La recuperación desaparece con el sistema de producción o falla cuando se necesita |
Actualiza solo cuando los cuatro elementos estén bajo tu control. Una copia manual del árbol de configuración puede mantenerse como capa adicional, pero el plan principal de recuperación debe ser una copia compatible que puedas descifrar y restaurar junto con un entorno de ejecución documentado.
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...
