Copias de seguridad

Guarda una copia de tu configuración para recuperarla tras una mala actualización, un disco roto o un cambio a un equipo nuevo.

Antes de empezar

• Settings > Backups (Ajustes > Copias de seguridad) necesita el permiso Change settings (cambiar ajustes). Solo el propietario restaura.
• Para descargar, borrar y restaurar hace falta un inicio de sesión con contraseña de los últimos minutos.

Hacer una copia de seguridad

1. Abre Settings > Backups.
2. Haz clic en Back up now (hacer una copia ahora). Deberías ver la copia nueva en Saved backups (copias guardadas).
3. Haz clic en Download (descargar) junto a ella para tener una copia fuera del servidor.

Guardar la clave maestra

Las copias de seguridad nunca incluyen la clave maestra, que abre las contraseñas y las claves de API de tus ajustes. Sin la clave que corresponde, una copia restaurada no puede leerlas.

1. En Master key (clave maestra), el propietario hace clic en Download key kit (descargar el kit de la clave).
2. Guarda el archivo lejos del servidor y separado de tus copias de seguridad. Deberías ver que la advertencia del kit de la clave desaparece de Settings > Backups y de las comprobaciones de salud.

Para usarlo más adelante, cámbiale el nombre a holyarrs.key y ponlo en la carpeta de configuración. ¿No eres el propietario? Pídele que lo descargue.

Restaurar una copia de seguridad

Peligro

Los cambios hechos después de la copia se pierden. Ten lista antes la clave maestra que corresponde.

1. Haz clic en Restore from a file (restaurar desde un archivo) y elige un zip de copia de seguridad de HolyArrs.
2. Confirma.
3. HolyArrs comprueba el archivo. Deberías ver Restore ready. It applies on the next start. (Restauración lista. Se aplica en el próximo inicio.)
4. HolyArrs se reinicia y pone la copia en su sitio. Con la política de reinicio de Docker recomendada, esto ocurre solo.

Tus bases de datos actuales pasan a /config/backups/before-restore-<time>, así que puedes deshacer una restauración.

Opciones

Cada cuánto

Opción	Hace copia	Conserva
Balanced (equilibrado, predeterminado)	Cada día	Los últimos 7 días y 4 copias semanales
Light (ligero)	Una vez por semana	4 semanas. Ocupa menos espacio
Careful (cuidadoso)	Cada día	Todas las copias durante 30 días

La copia programada más reciente se conserva siempre. Estas reglas solo limpian las copias programadas. Las copias que haces tú se quedan hasta que las borras (botón de papelera en la fila; no se puede deshacer). HolyArrs también hace una copia antes de una actualización que cambia los datos guardados y conserva las 3 más recientes; consulta Actualizaciones.

Pasar a un equipo nuevo

Una instalación nueva crea su propia clave maestra en el primer inicio. Esa clave no puede abrir tus copias anteriores, así que la restauración se rechaza. Pon antes la clave anterior en su sitio. Los ejemplos llaman holyarrs al contenedor; usa tu propio nombre.

1. Antes del primer inicio, crea el contenedor sin iniciarlo: docker compose create, o tu línea de docker run con docker create en lugar de docker run -d.
2. Copia dentro tu clave anterior: docker cp holyarrs.key holyarrs:/config/. Un kit de la clave renombrado a holyarrs.key también sirve. Funciona con un volumen con nombre o con una carpeta del host; HolyArrs entrega los archivos de /config a tu PUID y PGID al iniciarse. Si usas HOLYARRS_MASTER_KEY_FILE, pon la clave en esa ruta del host, con permiso de lectura para tu PUID y PGID.
3. Restaura la copia de seguridad. Elige una forma:

   • Inicia HolyArrs, termina el primer inicio y luego usa Restore from a file en Settings > Backups.

   • O restaura antes del primer inicio. Pon el zip, sin cambiarle el nombre, en una carpeta llamada backups y cópiala dentro con docker cp backups holyarrs:/config/. Luego ejecuta la restauración una vez con la misma imagen:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     Con una ruta de archivo de clave, añade -e HOLYARRS_MASTER_KEY_FILE=<its path> para que la restauración se compruebe con tu clave. restore --list muestra los nombres de las copias que puede ver.

4. Inicia HolyArrs. Deberías ver de nuevo tu Biblioteca y tus ajustes.

¿Iniciaste la instalación nueva antes de copiar la clave? Si no hay nada en ella que valga la pena conservar, detén HolyArrs, copia tu clave anterior encima de la nueva con el mismo docker cp, restaura y luego inicia.

Si no funciona

Síntoma: “Backups are off in this build” (las copias de seguridad están desactivadas en esta compilación). Causa: esta copia funciona sin su gestor de copias de seguridad. Solución: ninguna en la app; no hay controles de copias de seguridad.

Síntoma: descargar, borrar o restaurar te pide la contraseña. Causa: necesitan un inicio de sesión reciente con contraseña. Solución: inicia sesión otra vez con tu contraseña y vuelve a intentarlo.

Síntoma: la restauración se rechaza por la clave maestra. Causa: la clave de la carpeta de configuración no corresponde a la copia. Solución: vuelve a poner el holyarrs.key que corresponde e inténtalo de nuevo.

La restauración también rechaza un zip demasiado grande o dañado, con archivos inesperados, que viene de una versión más nueva de la base de datos o con datos que tu clave no puede leer.

Para expertos

Qué hay en una copia de seguridad

Cada copia es un zip con la base de datos principal, la base de datos de eventos si existe y backup.json (versión de HolyArrs, versiones de las bases de datos, tipo de copia, hora de creación). No incluye los archivos multimedia, las descargas, las imágenes, los registros ni la clave maestra.

Restaurar antes del primer inicio

docker cp funciona con un volumen con nombre o con una carpeta del host; HolyArrs entrega los archivos de /config a tu PUID y PGID al iniciarse. Con HOLYARRS_MASTER_KEY_FILE, pon la clave en esa ruta del host, con permiso de lectura para PUID y PGID.

1. Pon el zip, sin cambiarle el nombre, en una carpeta llamada backups y cópiala dentro: docker cp backups holyarrs:/config/.
2. Ejecuta la restauración una vez con la misma imagen:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. Con una ruta de archivo de clave, añade -e HOLYARRS_MASTER_KEY_FILE=<its path> para que la restauración se compruebe con tu clave.
4. Inicia HolyArrs.

restore --list muestra los nombres de las copias que puede ver.

Relacionado

• Actualizaciones
• Instalación
• Comprobaciones de salud