Cómo evitar que las copias de seguridad de Home Assistant capturen un estado incoherente de la base de datos

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.

Evita las copias de seguridad incoherentes de Home Assistant dejando que la aplicación coordine el estado de la base de datos activa o deteniendo las escrituras antes de hacer una copia directa del sistema de archivos.

El riesgo no es simplemente «hacer una copia de seguridad mientras Home Assistant está encendido»; es usar un método de copia que captura archivos relacionados de la base de datos y de la aplicación en momentos distintos, sin conocer el estado de sus transacciones. Las copias de seguridad integradas pueden coordinar los componentes de Home Assistant, mientras que una herramienta genérica de rsync o de instantáneas quizá no pueda hacerlo. Define qué mecanismo garantiza la coherencia, evita que se solapen trabajos que carguen mucho la base de datos, conserva la copia de seguridad válida anterior y verifica cada política mediante una restauración aislada.

No trates una base de datos SQLite activa como un archivo estático cualquiera

Recorder de Home Assistant puede estar escribiendo mientras un proceso genérico de copia de seguridad copia el directorio de configuración. Con SQLite, el estado confirmado puede abarcar la base de datos principal y los archivos de registro o WAL, así que capturar momentos distintos puede crear una copia incompleta o irrecuperable, aunque todos los nombres de archivo estén presentes en el archivo.

Una prueba de copia de seguridad de SQLite activa mostró que copiar solo el archivo principal de la base de datos podía omitir silenciosamente filas confirmadas que aún estaban en el WAL, incluso cuando la base de datos copiada superaba una comprobación de integridad. Ese fallo de copia respaldada por WAL es la razón por la que una copia directa de archivos debe usar una instantánea compatible con la base de datos o hacerse únicamente después de que esta se haya detenido limpiamente.

Eso no significa que siempre haya que apagar Home Assistant para hacer una copia de seguridad. Significa que el mecanismo debe saber crear un punto de recuperación coherente. Usa la copia de seguridad integrada de Home Assistant en una instalación en funcionamiento; reserva las copias del sistema de archivos con el servicio detenido para migraciones, archivado sin conexión o herramientas externas que no tengan integración compatible con la aplicación.

Evita trabajos de copia de seguridad o mantenimiento simultáneos durante el mismo intervalo

Incluso una copia de seguridad compatible con la aplicación puede fallar al preparar la base de datos si otro proceso mantiene bloqueos o si la ruta de almacenamiento está sometida a una carga de mantenimiento inusual. No programes una segunda copia de seguridad de un complemento, el mantenimiento de la base de datos, una instantánea del NAS y una copia de seguridad de Home Assistant para que empiecen en el mismo minuto solo porque la casa está tranquila.

Los informes reales sobre fallos de copias de seguridad de Home Assistant mencionan errores de preparación del bloqueo de la base de datos, y un usuario relacionó un conflicto con otro complemento de copias de seguridad. Es una señal preventiva: conviene separar las herramientas que se solapan y comprobar en el registro de la aplicación que se completa la etapa previa a la copia de seguridad.

Programa las ventanas de mantenimiento de forma escalonada y registra la duración prevista. Si una copia de seguridad suele quedarse esperando a Recorder, identifica primero quién mantiene el bloqueo o cuál es el problema de la base de datos. No aumentes los tiempos de espera a ciegas ni ejecutes más copias en paralelo: más tareas de copia de seguridad pueden agravar precisamente la contención que intentas evitar.

Para las copias directas del sistema de archivos, detén Home Assistant y conserva el conjunto de datos completo

Si tu política exige copiar directamente el directorio de configuración, detén Home Assistant correctamente antes de copiarlo, verifica que el proceso ya no esté escribiendo y copia todo el estado necesario en lugar de seleccionar únicamente el archivo principal de la base de datos. Mantén las copias de seguridad de bases de datos externas sujetas a su propio método de coherencia.

La comparación de ZimaSpace entre las copias de seguridad de Home Assistant en ejecución y con el servicio detenido establece el mismo límite: una copia de seguridad en vivo compatible con la aplicación y la copia directa del sistema de archivos son procedimientos distintos y no deben mezclarse en una sola regla.

Después de copiar, reinicia el servicio y verifica que Recorder funcione con normalidad. Si el destino de la copia de seguridad es un almacenamiento de red, verifica también que el conjunto de archivos se haya completado antes de retirar el montaje de red. Una copia interrumpida a mitad del proceso con el servicio detenido solo es coherente en el sentido limitado de que su origen no estaba activo; aun así, no constituye un punto de recuperación completo.

Confía en la copia de seguridad solo después de superar una restauración aislada

Crea una instancia temporal de Home Assistant o un destino de recuperación y restaura allí la copia de seguridad candidata sin tomar archivos mutables de producción. Verifica los usuarios existentes, los datos históricos, los paneles, las integraciones, las definiciones de automatizaciones y al menos un reinicio. Registra el tiempo de restauración y cualquier ajuste manual necesario para que la instancia funcione.

Una regresión de Home Assistant Core específica de la versión 2026.7.2 registró que Recorder fallaba al crear su punto de control WAL durante la fase previa a la copia de seguridad, tras lo cual el administrador de copias de seguridad agotaba el tiempo de espera del bloqueo de la base de datos. Esa señal de fallo previo a la copia de seguridad debe considerarse únicamente como evidencia de esa ruta afectada y como un punto de recuperación fallido, no como prueba de que todos los tiempos de espera agotados por bloqueos tengan la misma causa.

Supera la política cuando solo un mecanismo de copia de seguridad se ocupa de la coherencia en cada momento, se completa la fase de preparación de la base de datos, se conserva la copia anterior que se sabe que es correcta y una restauración reproduce los usuarios, el historial, la configuración y el comportamiento normal tras el reinicio. Si la prueba de restauración falla, conserva las pruebas y crea una nueva copia de seguridad compatible o una copia controlada con el servicio detenido antes de eliminar puntos de recuperación anteriores.

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.