Recrear una pila de Home Assistant con Docker o Compose no debería borrar la configuración si se vuelve a montar el mismo almacenamiento persistente de /config. Si aparece el proceso de configuración inicial o parecen faltar integraciones tras recrearla, la primera hipótesis debería ser que el nuevo contenedor está viendo una ubicación de almacenamiento distinta, 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 antigua. Un directorio vacío equivocado puede parecer exactamente una pérdida de configuración, aunque los datos originales sigan intactos en otra parte del host.
Comprueba 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 antiguo o el registro de implementación, en lugar de confiar en un nombre de carpeta que te resulte familiar.
Los montajes de enlace de Docker reemplazan la vista que el contenedor tiene del directorio de destino, y la documentación actual sobre montajes de enlace 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, si la ruta de origen está vacía o es incorrecta, Home Assistant verá un /config vacío.
No ejecutes el proceso de configuración inicial ni empieces a crear nuevas integraciones hasta comprobar el montaje. Escribir datos nuevos en el directorio equivocado hace que la recuperación posterior sea más confusa.
Distingue los montajes de enlace de los volúmenes con nombre
Una pila de Compose puede usar una ruta explícita del host o un volumen con nombre administrado por Docker. Recrear un proyecto con otro nombre de proyecto, nombre de volumen o ruta puede crear un nuevo almacenamiento persistente vacío mientras el volumen antiguo sigue existiendo.
Una guía actual sobre los volúmenes de Docker explica que los volúmenes con nombre almacenan datos de forma independiente de cada contenedor y pueden volver a adjuntarse después de reemplazar un contenedor. Por eso, eliminar un contenedor no es lo mismo que eliminar o reemplazar su almacenamiento persistente.
Enumera los volúmenes antiguos y nuevos, inspecciona sus puntos de montaje desde Docker y compara las fechas de creación y el contenido. Evita los comandos de limpieza hasta saber qué volumen contiene el estado de Home Assistant que debe conservarse.
Los archivos ocultos pueden hacer que una copia parezca completa cuando no lo está
Home Assistant almacena estado importante gestionado desde la interfaz de usuario en rutas ocultas como .storage. Un comando de copia en el shell que usa un comodín como *, o un administrador de archivos que oculta los archivos ocultos, puede mover archivos YAML y dejar atrás, sin avisar, datos esenciales del registro y de las integraciones.
Un caso de migración de Docker a Compose de 2025 reprodujo exactamente este problema de límites: una operación de copia omitió o gestionó mal 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 sus metadatos.
Compara los listados de directorios que incluyen archivos ocultos y verifica la propiedad, las marcas de tiempo y la presencia de los directorios ocultos esperados antes de concluir que los datos están dañados.
Comprueba los permisos antes de volver a copiar los datos
El directorio correcto puede seguir pareciendo inutilizable si el contenedor recreado no tiene permiso para leerlo o escribir en él. Esto es común después de mover los datos a un sistema de archivos nuevo, cambiar el modo de Docker, restaurar desde otro host o cambiar 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. Una discrepancia de permisos o de propiedad de solo lectura 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 todos a todo el árbol de configuración.
Recrea la pila solo después de comprobar la ruta persistente
Usa la definición de Compose, la etiqueta de imagen, el modo de red, los dispositivos y la ruta de origen de /config exactos que sabes que funcionan. Inicia Home Assistant y verifica que vuelvan los usuarios, paneles, integraciones, automatizaciones y asistentes esperados antes de permitir migraciones o cambios de configuración nuevos.
El flujo de recuperación de un solo contenedor de ZimaSpace aplica la misma regla: inspecciona los montajes efectivos y vuelve a conectar las dependencias en buen estado antes de restaurar o reemplazar partes no relacionadas de una pila.
Si faltan realmente los datos de origen, recurre a la restauración desde una copia de seguridad. Si están presentes, pero el nuevo contenedor no puede verlos ni modificarlos, el problema está en la asignación del almacenamiento o en los permisos, no en la propia configuración de Home Assistant.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



