Cómo saber si Home Assistant está usando el archivo de configuración esperado

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Home Assistant está usando el archivo de configuración esperado solo cuando el directorio de configuración indicado en tiempo de ejecución, la ruta del host montada y una prueba de validación controlada apuntan al mismo archivo.

Esta confusión es frecuente cuando /config existe dentro de un contenedor, pero está asignado a otro directorio del host, o cuando tanto un montaje bind antiguo como una copia recién editada contienen configuration.yaml. Primero anota la ruta en tiempo de ejecución, rastrea su montaje sin modificarlo, compara la identidad y las marcas de tiempo de los archivos y, luego, usa un marcador inocuo y reversible para comprobar qué árbol lee la instancia en ejecución.

Anota el directorio de configuración indicado por la instancia en ejecución

Abre Información del sistema desde la instancia de Home Assistant en ejecución y anota exactamente el directorio de configuración que se muestra. Anota también el tipo de instalación, la versión de Core, el nombre del contenedor o la VM y la hora del último reinicio correcto. Así se establece la vista en tiempo de ejecución antes de que las rutas del host compliquen las cosas.

Las explicaciones de la comunidad muestran por qué /config puede referirse a una ruta interna, mientras que el directorio correspondiente del host varía según la instalación. La distinción útil es dentro y fuera del contenedor, no una ubicación universal del sistema de archivos.

Si el directorio indicado contiene el archivo que editaste dentro del mismo espacio de nombres en tiempo de ejecución, continúa con la comprobación del archivo. Si no es así, deja de editar esa copia. Si la interfaz no está disponible, inspecciona el proceso o los argumentos y montajes del contenedor en ejecución en lugar de hacer conjeturas basadas en un tutorial antiguo.

Rastrea la ruta del host a través del montaje activo

Inspecciona el contenedor en ejecución o el servicio de Compose y busca el origen asignado al directorio de configuración en tiempo de ejecución. Resuelve las rutas relativas desde el directorio real del proyecto de Compose. En una instalación en una VM o HAOS, distingue la ruta del sistema invitado del almacenamiento visible para el hipervisor.

Un problema documentado en un proyecto de Home Assistant describía la confusión que se produjo cuando la interfaz mostraba la ruta dentro del contenedor, mientras que los datos reales del host HAOS estaban en otro lugar. Ese caso de rutas del host frente al contenedor sirve para rastrear el montaje, no para copiar su ruta exacta en otra instalación.

Compara el origen del montaje activo con el directorio de tu editor o recurso compartido de archivos. Si son distintos, no los combines todavía. Conserva ambos árboles, anota sus fechas de modificación y tamaños e identifica cuál contiene el registro de entidades actual, las automatizaciones y la actividad reciente del registro.

Demuestra la identidad del archivo con un cambio controlado y seguro

Antes de probar, comprueba la configuración en el mismo entorno de ejecución y haz una copia de seguridad del árbol activo. Añade un comentario inocuo con un nombre único u otro marcador reversible al archivo sospechoso, guárdalo y confirma que la marca de tiempo cambia en la ubicación a la que apunta el montaje de ejecución.

Usa el proceso habitual de validación de la configuración y, cuando sea posible, vuelve a cargar solo el dominio pertinente que admita recarga. Si es necesario reiniciar por completo, hazlo una vez tras la validación y revisa el registro para comprobar el archivo o la integración que modificaste. Reiniciar sin verificar la ruta puede hacer que se vuelva a cargar el archivo equivocado.

El artículo relacionado de ZimaSpace sobre la ruta de datos de Home Assistant ayuda a distinguir el estado visible del frontend de los archivos persistentes de configuración y registro que lo generaron.

Corrige el montaje y verifica la persistencia

Si se monta el origen equivocado, detén Home Assistant, conserva ambos directorios y corrige únicamente la definición del montaje que recrea el contenedor. Confirma la propiedad y los permisos antes del inicio. No copies un árbol antiguo sobre un estado más reciente a menos que hayas decidido explícitamente qué datos prevalecen.

Después del inicio, repite la comprobación de la ruta de ejecución, el montaje, la marca de tiempo, la configuración y el marcador. Un resultado satisfactorio demuestra que se lee el archivo esperado, que los registros actuales siguen presentes y que la misma correspondencia se mantiene tras recrear el contenedor o reiniciar el host.

Vuelve al montaje anterior si Home Assistant se inicia vacío, pierde integraciones o informa de errores de permisos. Si la correspondencia sigue sin estar clara, escala el caso indicando el tipo de instalación, el directorio de ejecución, el origen y el destino del montaje y un listado saneado del directorio; elimina los árboles duplicados solo cuando la recuperación se haya verificado de forma independiente.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.