¿Por qué Home Assistant pierde el acceso a los datos persistentes después de recrear la pila?

Recrear una pila de Docker o Compose de Home Assistant no debería borrar la configuración cuando se vuelve a montar el mismo contenido persistente de /config. Cuando aparece el proceso de incorporación o parecen faltar integraciones después de la recreación, la primera suposición debería ser que el nuevo contenedor está viendo una vista de almacenamiento diferente, no que Home Assistant haya eliminado el estado del hogar.

Inspecciona el montaje efectivo, la ruta del host, el volumen con nombre, los archivos ocultos y los permisos antes de restaurar una copia de seguridad anterior. Un directorio vacío incorrecto puede parecer exactamente una pérdida de configuración, aunque los datos originales sigan intactos en otra ubicación del host.

Verifica qué está montado realmente en /config

Inspecciona el contenedor en ejecución y confirma el origen del montaje asignado a /config. Compáralo con el archivo Compose anterior o con el registro de despliegue, en lugar de confiar en un nombre de carpeta conocido.

Los montajes bind de Docker reemplazan la vista que tiene el contenedor del directorio de destino, y la documentación sobre montajes bind señala que montar un directorio del host sobre una ruta del contenedor que no está vacía oculta los archivos que ya estaban allí. Por tanto, una ruta de origen vacía o incorrecta hace que Home Assistant vea un /config vacío.

No ejecutes el proceso de incorporación ni empieces a crear nuevas integraciones hasta comprobar el montaje. Las nuevas escrituras en el directorio incorrecto harán que la recuperación posterior sea más confusa.

Distingue entre montajes bind y volúmenes con nombre

Una pila de Compose puede utilizar una ruta explícita del host o un volumen con nombre gestionado por Docker. Recrear un proyecto con un nombre de proyecto, nombre de volumen o ruta diferente puede crear un nuevo almacén persistente vacío mientras el volumen anterior sigue existiendo.

Una guía actual sobre volúmenes de Docker explica que los volúmenes con nombre almacenan los datos independientemente de cada contenedor y pueden volver a conectarse después de reemplazar un contenedor. Por tanto, eliminar un contenedor es diferente de eliminar o reemplazar su almacenamiento persistente.

Enumera los volúmenes antiguos y nuevos, inspecciona sus puntos de montaje mediante Docker y compara las fechas de creación y el contenido. Evita los comandos de limpieza hasta saber qué volumen contiene el estado autorizado de Home Assistant.

Los archivos ocultos pueden hacer que una copia parezca completa cuando no lo está

Home Assistant almacena información importante gestionada desde la interfaz en rutas ocultas como .storage. Una copia desde el shell utilizando un comodín como *, o un gestor de archivos que oculte los archivos de punto, puede mover los archivos YAML y dejar silenciosamente atrás el estado crítico de registros e integraciones.

Un caso de migración de Docker a Compose de 2025 reprodujo exactamente este problema: una operación de copia omitió o gestionó incorrectamente el estado oculto de Home Assistant, y la migración solo se estabilizó después de copiar correctamente todo el árbol de configuración y los metadatos.

Compara los listados de directorios incluyendo los archivos ocultos y verifica el propietario, las marcas de tiempo y la presencia de los directorios ocultos esperados antes de concluir que los datos están dañados.

Featured

ZimaCube 2 NAS personal en la nube para el hogar

ZimaCube2

$799.00 - $2,499.00

Buy Now

Comprueba los permisos antes de volver a copiar los datos

El directorio correcto puede seguir pareciendo inutilizable cuando el contenedor recreado no tiene permiso para leerlo o escribir en él. Esto es habitual después de mover los datos a un sistema de archivos nuevo, cambiar el modo de Docker, restaurar desde otro host o modificar las asignaciones de UID/GID.

Una guía de resolución de problemas de Docker Engine verificada en 2026 reduce estos fallos a la ruta real del host, el UID/GID del contenedor, el acceso al directorio principal, el modo de montaje y los límites de seguridad. Un montaje de solo lectura o una discrepancia de propietario puede impedir que Home Assistant actualice el estado aunque los archivos sean visibles.

Corrige el problema específico de propiedad o montaje en lugar de aplicar permisos de escritura para todo el mundo a todo el árbol de configuración.

Recrea la pila solo después de comprobar la ruta persistente

Utiliza la definición de Compose exacta y conocida por funcionar, la etiqueta de imagen, el modo de red, los dispositivos y el origen de /config. Inicia Home Assistant y verifica que vuelvan los usuarios, paneles, integraciones, automatizaciones y asistentes esperados antes de permitir migraciones o nuevos cambios de configuración.

El flujo de recuperación de un solo contenedor de ZimaSpace aplica la misma regla: inspeccionar los montajes efectivos y volver a conectar las dependencias saludables antes de restaurar o reemplazar partes no relacionadas de una pila.

Si los datos autorizados realmente faltan, pasa a restaurar la copia de seguridad. Si están presentes pero el nuevo contenedor no puede verlos o modificarlos, el problema corresponde al mapeo del almacenamiento o al límite de permisos, no a la configuración de Home Assistant en sí.