Cómo configurar la caché y el almacenamiento temporal de Home Assistant

Configura la caché de Home Assistant identificando primero qué datos son desechables; nunca muevas toda la ruta de configuración persistente a un almacenamiento temporal.

«Caché» puede referirse a los recursos del frontend del navegador, la salida de TTS, los archivos temporales específicos de una integración, el /tmp de un contenedor, la caché de páginas del sistema operativo o el espacio de trabajo de la base de datos. Estas capas tienen distintos responsables y comportamientos de recuperación. Mantén los usuarios, registros, configuración, estado de Recorder y otros archivos de autoridad en un almacenamiento duradero. Usa tmpfs o almacenamiento respaldado por RAM solo para una ruta desechable documentada cuya pérdida y consumo de memoria hayas probado mediante un reinicio.

Clasifica la caché antes de mover cualquier ruta

Empieza por indicar el responsable, la ruta, el tamaño máximo previsto, el método de reconstrucción y qué ocurre si los datos desaparecen. La caché del navegador reside en el cliente; el estado persistente de la aplicación de Home Assistant se encuentra en la ruta de datos configurada; las cachés de las integraciones varían; los archivos temporales del contenedor pueden desaparecer al reiniciarse. No deben resolverse con un único ajuste global de «directorio de caché».

Un caso de TTS de Home Assistant muestra un ejemplo concreto en el que el audio generado en una ruta de caché específica se redirigió intencionadamente a una ubicación respaldada por RAM. El límite importante al mover una caché de TTS desechable es que el usuario seleccionó un único directorio regenerable, no todo el árbol de configuración.

Si no puedes demostrar que un archivo puede desaparecer sin perder la identidad, el historial, los ajustes, los paneles o el registro de una integración, clasifícalo como persistente. La opción predeterminada más segura es el almacenamiento duradero. La optimización viene después de conocer quién se encarga de la recuperación.

Mantén el estado persistente de Home Assistant y Recorder en un almacenamiento duradero

El volumen de configuración no es una caché solo porque contenga algunos archivos generados. Puede incluir autenticación, registros de entidades y dispositivos, estado de automatizaciones, configuración, componentes personalizados y la base de datos predeterminada de Recorder. Colocar toda esa ruta en tmpfs convierte un reinicio en una pérdida de datos y hace que las copias de seguridad dependan de contenidos de la memoria que nunca debieron ser autoritativos.

La explicación de ZimaSpace sobre los roles de los datos persistentes de Home Assistant es el filtro inicial correcto: separa el estado autoritativo de la caché reconstruible y los datos de trabajo temporales antes de asignar niveles de almacenamiento.

Usa un SSD u otro sistema de archivos duradero y fiable para el estado de la aplicación, y reserva suficiente espacio libre para el crecimiento de la base de datos, las actualizaciones y el mantenimiento. Mover una pequeña caché desechable a la RAM no compensa un volumen persistente insuficiente o defectuoso.

Usa tmpfs solo para rutas explícitamente desechables y con un límite de memoria

Tmpfs puede reducir las escrituras y ofrecer una latencia muy baja, pero consume RAM del host y desaparece cuando se detiene el contenedor o el host. Por eso es adecuado para datos temporales acotados, no para nada que sea necesario después de un reinicio. El montaje también debe dimensionarse de modo que una carga temporal no consuma la memoria que necesitan Home Assistant Core y los servicios cercanos.

Una guía actual de Docker Compose explica que el uso de tmpfs cuenta para la capacidad de memoria y puede provocar errores de falta de espacio o OOM cuando su tamaño es excesivo o no está limitado en relación con el presupuesto del contenedor.

Establece un límite máximo de tamaño, supervisa el uso máximo y reinicia deliberadamente el contenedor. La ruta debería volver a poblarse automáticamente, mientras los usuarios, los ajustes, el historial y las integraciones permanecen sin cambios. Si la aplicación no puede reconstruir el directorio o considera que su ausencia indica corrupción, devuélvelo al almacenamiento duradero.

Featured

ZimaCube 2 NAS personal en la nube para el hogar

ZimaCube2

$799.00 - $2,499.00

Buy Now

Considera la caché del frontend un problema del cliente, no del almacenamiento del servidor

Una página obsoleta de Home Assistant en un navegador puede persistir aunque el servidor funcione correctamente, porque el navegador o la aplicación almacenan en caché los recursos del frontend. Borrar archivos temporales del servidor no solucionará ese estado del cliente. Del mismo modo, borrar la caché del navegador no reduce la E/S de disco de Recorder ni hace más pequeña la base de datos de Home Assistant.

Los usuarios de Home Assistant distinguen explícitamente la caché del frontend como caché del navegador, por lo que la solución de problemas debe comenzar determinando si el síntoma existe en un solo cliente o en todo el servidor.

Usa un navegador limpio o un perfil privado como control de validación. Si el cliente nuevo funciona correctamente, aplica la solución en el frontend. Si todos los clientes muestran los mismos datos faltantes o el mismo error del servidor, no sigas borrando cachés locales; vuelve a investigar los registros, el almacenamiento, la integración o la base de datos de Home Assistant.

Valida el almacenamiento temporal mediante pruebas de reinicio, presión y espacio libre

Después de cambiar una ruta de caché o tmpfs, mide el tamaño normal y máximo, la memoria disponible del host, la presión de memoria del contenedor, el espacio libre del volumen persistente y el comportamiento tras reiniciar. Después, ejecuta la carga que crea la caché —TTS, contenido multimedia, procesamiento de una integración personalizada u otro productor conocido— y confirma que la limpieza se realiza como se espera.

Deja margen en el almacenamiento duradero para las operaciones que necesitan espacio de trabajo temporal, aunque la base de datos diaria quepa holgadamente. No llenes el volumen persistente porque una caché en RAM haya hecho que las escrituras normales parezcan menores; las actualizaciones, el mantenimiento de la base de datos, las copias de seguridad y los picos de registros pueden tener necesidades de espacio temporal muy diferentes.

La prueba se supera cuando todas las rutas desechables pueden desaparecer y reconstruirse, el estado persistente sobrevive al reinicio del contenedor y del host, el uso máximo de tmpfs se mantiene dentro del presupuesto de memoria y Home Assistant conserva suficiente espacio libre duradero. Si algún ajuste o historial necesario desaparece después de la prueba, la ruta se clasificó incorrectamente y debe devolverse al almacenamiento persistente antes de continuar con la optimización.