Actualizaciones

HolyArrs te dice cuándo sale una versión nueva y nunca la instala. Tú descargas la imagen nueva cuando te venga bien.

Ver si hay una versión nueva

1. Abre la página Status (estado) (http://your-server:6262/health).
2. Lee Updates (actualizaciones). Deberías ver uno de estos mensajes:

Mensaje	Significado
“HolyArrs 1.2.0 is out, newer than this one.”	Actualiza cuando quieras
“This is the newest version.”	No hay nada que hacer
“No HolyArrs release is published yet.”	El feed está vacío. No pasa nada malo
“The last check did not work: …”	No se llegó al feed, a menudo por falta de internet
“The update check is off: …”	Desactivada en Ajustes

3. Para preguntar ahora, haz clic en Check now (comprobar ahora) o en Check again (comprobar de nuevo). Necesita el permiso Change settings (cambiar ajustes).

Una versión más nueva también aparece como advertencia de salud. Una comprobación fallida solo aparece en Updates.

Actualizar

1. Descarga la imagen nueva y reinicia: docker compose pull y luego docker compose up -d.
2. HolyArrs se inicia. Si la versión nueva cambia cómo se guardan los datos, primero hace una copia de seguridad y después actualiza los datos. Deberías ver que la app se abre en la versión nueva.

Consejo

Un paso de actualización que falla se deshace y HolyArrs se detiene en una página que explica qué pasó. Tus datos de antes de la actualización quedan como copia de seguridad.

Volver a la versión anterior

HolyArrs no puede cambiar su propia imagen, así que tú ejecutas la imagen anterior y HolyArrs recupera los datos anteriores.

Precaución

Todo lo que cambió después de la actualización, como títulos nuevos, ajustes e historial, no está en la copia de seguridad previa a la actualización.

1. Cambia la etiqueta de la imagen en tu archivo compose (o en docker run) por la anterior, por ejemplo holyarrs/holyarrs:<older version>.
2. Ejecuta docker compose up -d.
3. Si la actualización no cambió los datos, la versión anterior se inicia. Ya está.
4. Si no, la versión anterior muestra una página en lugar de la app. Haz clic en Put back the data from before the update (recuperar los datos de antes de la actualización).
5. Escribe el código de un solo uso. Encuéntralo con docker logs <container>; busca “one-time code”.
6. HolyArrs comprueba la copia de seguridad, la pone en su sitio y se detiene. Deberías ver que el contenedor se inicia de nuevo con esos datos gracias a su política de reinicio. Si no tiene ninguna, inícialo tú.

Sin la página: docker exec <container> /holyarrs restore --pre-update y luego docker restart <container>. Sin Docker: detén HolyArrs, ejecuta holyarrs restore --pre-update e inícialo.

No se elimina nada. Los datos más nuevos pasan a backups/before-restore-<time>/, así que puedes deshacerlo. Si vuelves más de una versión atrás, se elige la más reciente de las copias de seguridad previas a una actualización que esa versión pueda leer.

Opciones

Todas están en Settings > Health checks (Ajustes > Comprobaciones de salud). Las tres últimas están en la parte avanzada de la tarjeta.

Ajuste	Predeterminado	Cámbialo cuando
Check for a newer HolyArrs (comprobar si hay un HolyArrs más nuevo)	Activado	No quieres ninguna petición hacia fuera
Check for updates every (comprobar actualizaciones cada)	día	Quieres menos comprobaciones: 3, 7, 14 o 30 días
Release feed (feed de versiones)	Vacío (versiones de HolyArrs)	Alojas tu propio feed
Feed may be on the local network (el feed puede estar en la red local)	Desactivado	Tu feed está en tu propia red
Include test versions (like 1.2.0-rc1) (incluir versiones de prueba, como 1.2.0-rc1)	Desactivado	Quieres enterarte de las versiones de prueba

Si no funciona

Síntoma: “The last check did not work.” Causa: el servidor no tiene internet, o tu propio feed está en la red local. Solución: comprueba el acceso a internet o activa Feed may be on the local network.

Síntoma: el feed de versiones no se guarda. Causa: la dirección contiene un nombre, una contraseña, ?query o #fragment, o no empieza por http:// o https://. Solución: quita esas partes.

Síntoma: la actualización se detuvo por falta de espacio en disco. Causa: no hay sitio para la copia y la actualización. Solución: libera espacio donde está la carpeta de configuración y empieza de nuevo.

Síntoma: la página para volver atrás rechaza tu código. Causa: un código antiguo, o 10 códigos erróneos desde el último inicio. Solución: copia el código de la línea más reciente del registro (log). Tras 10 intentos erróneos, reinicia el contenedor y usa el código nuevo.

Funciones retenidas

Algunas funciones vienen desactivadas de forma predeterminada en esta versión. Actívalas bajo tu propia responsabilidad. Mientras están retenidas, sus páginas y elementos de menú están ocultos, sus rutas de API responden “not found” y sus tareas no se ejecutan. Los datos que guardaste para ellas se conservan.

Para activar una, añade su interruptor a HOLYARRS_FLAGS, separados por comas, y reinicia el contenedor:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Quita el nombre y reinicia para desactivarla. Los ajustes ocultos vuelven cuando la activas de nuevo.

Interruptor	Función
plex_watchlists	Las listas de seguimiento de Plex se convierten en solicitudes
row_title_stats	Estadísticas de títulos de las filas de Explorar en Apariencia
trakt_lists	Clave de Trakt, listas de Trakt y reseñas de Trakt. Las listas de TMDB siguen activas
alert_channels_more	Avisos por Telegram, ntfy, Gotify, Pushover y webhook. Discord y email siguen activos
subtitle_sites	Sitios de subtítulos y búsqueda de subtítulos. Tu idioma de subtítulos sigue activo
emby_signin	Iniciar sesión con Emby. La actualización de la biblioteca de Emby sigue funcionando
go_back	El panel Go back (volver atrás) de la página Estado. Los pasos de Volver a la versión anterior funcionan sin él

¿No cambió nada después de añadir un interruptor? Revisa cómo está escrito (minúsculas, guiones bajos) y reinicia el contenedor, no solo la página.

Para expertos

Qué envía la comprobación

Una petición a api.github.com para conocer la versión más nueva, solo con User-Agent: HolyArrs/<version>. Sin cuenta, clave ni lista de contenido. Con la comprobación desactivada, ninguna petición.

La última respuesta se guarda, así que un reinicio no comprueba antes de tiempo. Una comprobación espera como máximo 15 s, lee como máximo 512 KB y sigue como máximo 3 redirecciones, sin cambiar nunca entre http y https. El enlace a las notas de la versión solo aparece cuando apunta a las páginas de versiones de HolyArrs en GitHub; si no, la versión aparece como texto sin formato.

Release feed acepta una respuesta de versión al estilo de GitHub, una lista de versiones, cualquier JSON con version, o texto sin formato que contenga la versión. Las direcciones de metadatos de la nube se rechazan siempre. Una versión de prueba cuenta como más antigua que la versión normal.

La copia de seguridad antes de una actualización

Antes de cambiar los datos guardados, HolyArrs:

1. Comprueba que hay sitio para una copia y para la actualización. Si no, no cambia nada. Sáltalo con HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Copia cada base de datos a backups, comprueba la copia y escribe un archivo sha256 a su lado. Tras 3 copias fallidas, no cambia nada.
3. Ejecuta cada paso de la actualización por separado y lo comprueba. Un paso que falla se deshace; los pasos terminados se quedan. Inicia la misma versión otra vez para seguir desde el paso que falló con la misma copia.

Tras el primer inicio correcto, la copia pasa a ser holyarrs-backup-pre-update-<time>.zip, con una descripción como “before updating from 1.1.0 to 1.2.0”. Aparece en Settings > Backups (Ajustes > Copias de seguridad) y en holyarrs restore --list. Se conservan las 3 más nuevas; la programación de copias de seguridad nunca las quita. Una instalación nueva o una actualización que no toca los datos no crea ninguna.

Relacionado

• Copias de seguridad
• Comprobaciones de salud
• Partes y Modo seguro