Partes y Modo seguro

Desactiva las Partes que no usas, inicia en Modo seguro cuando algo falla y reinicia HolyArrs desde el navegador.

Activar o desactivar una Parte

HolyArrs tiene 5 Partes: Movies (películas), TV shows (series), Music (música), Subtitles (subtítulos) y Requests (Solicitudes). Las eliges por primera vez en el asistente del primer inicio.

1. Abre Settings > Parts (Ajustes > Partes).
2. Haz clic en Turn on (activar) o Turn off (desactivar) junto a una Parte. Deberías ver que sus elementos del menú aparecen o desaparecen.

No se borra nada. Vuelve a activar una Parte y sigue donde lo dejó.

Iniciar en Modo seguro

El Modo seguro inicia solo lo básico, para cuando algo impide que HolyArrs se inicie o funcione. Puedes iniciar sesión, ver tu Biblioteca, cambiar ajustes y hacer o restaurar una copia de seguridad. Buscar, añadir, actualizar datos, descargar e importar esperan al próximo inicio normal.

1. Abre Settings > Danger zone (Ajustes > Zona de peligro).
2. Haz clic en Restart in safe mode (reiniciar en Modo seguro). Deberías ver una franja de aviso en todas las páginas.
3. Resuelve el problema y luego haz clic en Restart HolyArrs (reiniciar HolyArrs). El próximo inicio es normal.

Si no puedes llegar a la página, pon HOLYARRS_SAFE_MODE=1 en Compose o inicia con -safe-mode. Quítalo después de la solución: los dos mantienen todos los inicios en Modo seguro.

Opciones

Qué se detiene cuando una Parte está desactivada

Parte	Se detiene	Sigue funcionando
Movies	Páginas y elementos del menú de películas, añadir, buscar, actualizar datos	Las descargas que ya están en tu gestor de descargas se siguen vigilando. Los archivos se quedan.
TV shows	Páginas de series, añadir, buscar, búsquedas de temporadas, actualizaciones de datos	Igual que Movies.
Music	Páginas de artistas y álbumes, ajustes de música, actualizaciones de datos de artistas, búsquedas de álbumes	Igual que Movies.
Subtitles	Ajustes de subtítulos, la página de subtítulos que faltan, búsquedas y comprobaciones	Los archivos de subtítulos que están junto a tus vídeos se quedan.
Requests	Páginas de solicitudes y pedir títulos	Las solicitudes que ya existen se quedan y vuelven cuando se activa de nuevo.

Siempre activo: inicio de sesión y cuentas, carpetas de la Biblioteca, Fuentes, gestores de descargas y descargas, avisos, Historial, copias de seguridad, comprobaciones de salud, ajustes y la API.

• Subtitles necesita Movies o TV shows. Requests necesita Movies, TV shows o Music. HolyArrs rechaza un cambio que rompa esto y dice qué cambiar antes.
• Una tarea en cola de una Parte desactivada espera y se ejecuta cuando la Parte se activa.
• Desactivar una Parte no ahorra memoria. Todo se ejecuta en un solo programa.

Reiniciar, pausar y apagar

Settings > Danger zone (propietario y administradores) tiene Restart HolyArrs, Restart in safe mode y Shut down (apagar), además de Pause (pausar), Resume (reanudar) y Restart (reiniciar) para cada tarea en segundo plano, como las copias de seguridad o la sincronización de descargas.

• Los controles que detienen algo te piden confirmar en un plazo de 60 s.
• Cada control que se usa queda escrito en el Historial con tu nombre.
• Necesitas un inicio de sesión con contraseña. Un inicio de sesión sin contraseña en tu red local se rechaza.

Reiniciar detiene HolyArrs de forma limpia y deja que Docker lo inicie otra vez, así que pon restart: unless-stopped.

Política de reinicio	Reiniciar	Apagar
unless-stopped o always	Vuelve	Vuelve también
on-failure	Vuelve	Se queda apagado
no	Se queda apagado	Se queda apagado

Si no funciona

Síntoma	Causa	Solución
HolyArrs no puede desactivar una Parte	Otra Parte la necesita	Desactiva antes esa Parte, como dice el mensaje.
Reiniciar apagó HolyArrs del todo	La política de reinicio es no	Inicia el contenedor y pon restart: unless-stopped.
Los controles se rechazan	Inicio de sesión local sin contraseña, o a la clave le falta control	Inicia sesión con tu contraseña.
Una tarea sigue en failed	Te necesita	Lee el motivo en /health, resuélvelo y haz clic en Restart para esa tarea.

Más soluciones: Solución de problemas.

Para expertos

Estados de salud

/health, Settings > Parts y GET /api/v1/health/states muestran cada tarea en segundo plano, Parte y app vinculada con un estado y un motivo.

Estado	Significado
off	Desactivado, en pausa o no iniciado en Modo seguro.
starting	Iniciándose, o aún sin comprobar.
running	Funciona.
retrying	Falló; HolyArrs lo intenta de nuevo, esperando más cada vez.
failed	Se cayó, se atascó o te necesita. El motivo dice qué hacer.

Una tarea que se cayó muestra failed, luego retrying y después se inicia otra vez. Mientras tanto, el inicio de sesión, la Biblioteca y las copias de seguridad siguen funcionando. Una tarea atascada se libera con un reinicio completo.

Memoria y modo de poca memoria

HolyArrs intenta mantenerse por debajo de 384 MiB, lo que cabe en un límite de contenedor de 500 MB. Para fijar tu propio objetivo, pon GOMEMLIMIT en cerca del 80 por ciento de la memoria del contenedor.

El modo de poca memoria guarda menos en memoria y lee más de la base de datos. Algunas páginas tardan un momento más, y el trabajo en segundo plano, como la copia del catálogo de música, se ejecuta con menos frecuencia.

Ajuste	Efecto
(predeterminado, Linux)	Se activa solo con unos 2.5 GiB de memoria o menos.
HOLYARRS_LOW_MEMORY=1	Siempre activado.
HOLYARRS_LOW_MEMORY=0	Siempre desactivado.

La primera línea del registro (log) dice si está activado y por qué.

Alcances de las claves de API

Crea una clave en Settings > API > API keys (Ajustes > API > Claves de API) y envíala en la cabecera X-Api-Key.

Alcance	A qué llega
read	Biblioteca, tareas, descargas, historial, salud, ajustes. Secretos ocultos.
health_read	Solo los estados de salud. Para herramientas de monitorización.
write	Todos los cambios menos las rutas de administración y los controles.
admin	Personas, invitaciones, límites de solicitudes, claves de API, contraseña e inicio de sesión en dos pasos, ajustes de inicio de sesión, copias de seguridad.
control	Los controles de esta página. Solo el propietario y los administradores pueden concederlo.
all	read, write y admin. No control.

Una clave nunca hace más que la persona que la creó. Los alcances no se pueden cambiar después; crea una clave nueva. Todas las rutas y su alcance: /api/v1/openapi.json.

Relacionado

• Comprobaciones de salud
• Copias de seguridad
• Rutas de la API