Variables de entorno

Todas las variables que lee el contenedor de HolyArrs. La mayoría de las instalaciones solo definen PUID, PGID y TZ.

Comunes

Variable	Qué hace	Predeterminado	Ejemplo
PUID, PGID	Usuario y grupo con los que se ejecuta HolyArrs. Deben ser propietarios de /config y de tus carpetas de medios.	1000, 1000	PUID=1000
TZ	Zona horaria para las programaciones y los registros.	Etc/UTC	TZ=Europe/Amsterdam
UMASK	Bits de permiso que los archivos nuevos no llevan. Solo afecta a los archivos nuevos.	022	UMASK=002
HOLYARRS_SAVE_PATH	La carpeta donde guarda el gestor de descargas, tal como la ve el gestor de descargas. Se envía con cada descarga.	ninguno	/data/downloads
HOLYARRS_URL_BASE	Sirve HolyArrs bajo una ruta detrás de un proxy inverso. / ignora la ruta guardada en Ajustes.	ninguno	/holyarrs
HOLYARRS_ALLOWED_HOSTS	Nombres de host adicionales con los que la gente llega a HolyArrs, separados por comas.	IPs y localhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	La dirección o la red de tu proxy inverso, separadas por comas. Hace falta para ver las direcciones reales de los clientes.	ninguno	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	Lee la clave maestra de la bóveda desde su propio archivo. El usuario de PUID debe poder leerlo.	/config/holyarrs.key	/keys/holyarrs.key

Valores desde archivos

Pon FILE__ delante de cualquier variable para leer su valor desde un archivo, como un secreto de Docker.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

HolyArrs quita un salto de línea al final del archivo. Si el archivo no existe, HolyArrs se detiene y el registro (log) indica la variable y el archivo, nunca el valor.

Recuperación y solución de problemas

Variable	Qué hace	Predeterminado	Ejemplo
HOLYARRS_SAFE_MODE	Inicia solo lo esencial: inicio de sesión, Biblioteca, ajustes, copias de seguridad y salud. Quítala después de arreglar el problema.	desactivado	1
HOLYARRS_LOW_MEMORY	1 fuerza el modo de poca memoria, 0 lo impide. Sin definir, se activa con unos 2.5 GiB de RAM o menos.	según el tamaño del equipo	1
GOMEMLIMIT	Cambia el objetivo de memoria que HolyArrs se fija a sí mismo.	lo fija HolyArrs	1GiB
HOLYARRS_SKIP_SPACE_CHECK	Omite la comprobación de espacio libre antes de actualizar la base de datos.	desactivado	yes
HOLYARRS_CONFIG_IN_MEMORY	Permite /config en una carpeta que vive en memoria. Para equipos de prueba; los datos se pierden al reiniciar.	desactivado	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	Inicia con /config en una carpeta compartida de Docker Desktop en un Mac, después de comprobar que los bloqueos de archivos funcionan ahí. HolyArrs muestra una advertencia en cada inicio.	desactivado	1
HOLYARRS_READONLY_DOWNLOADERS	Gestores de descargas que HolyArrs nunca debe cambiar, por id o por dirección, separados por comas.	ninguno	3,http://qbit:8080
HOLYARRS_HEALTH_URL	Dirección a la que llama la comprobación de salud del contenedor.	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

Las variables de activar o desactivar aceptan 1, true, yes u on.

Inicio de sesión único

Defínelas antes de iniciar. Si HOLYARRS_OIDC_ENABLED está presente, aunque sea como false, el entorno manda sobre el inicio de sesión único (SSO) y Ajustes solo lo muestra. Las de activar o desactivar de esta tabla solo aceptan true o false; cualquier otro valor impide el inicio.

Variable	Qué hace	Predeterminado
HOLYARRS_OIDC_ENABLED	Activa el inicio de sesión único.	false
HOLYARRS_OIDC_ISSUER	El emisor HTTPS exacto del proveedor.	ninguno
HOLYARRS_OIDC_CLIENT_ID	Id de cliente registrado.	ninguno
HOLYARRS_OIDC_CLIENT_SECRET_FILE	Archivo con el secreto del cliente, de 4096 bytes como máximo. Omítela para un cliente público.	ninguno
HOLYARRS_OIDC_REDIRECT_URL	Dirección de retorno exacta: tu dirección, la URL base si la hay, y luego /api/v1/auth/oidc/callback.	ninguno
HOLYARRS_OIDC_ALLOW_JOIN	Las personas nuevas entran como miembros que solo pueden pedir.	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	Permite un proveedor en tu red privada.	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	Permite HTTP sin cifrar en este equipo, para pruebas.	false
HOLYARRS_FORWARD_AUTH_ENABLED	Activa el inicio de sesión mediante un proxy de confianza.	false
HOLYARRS_FORWARD_AUTH_ISSUER	Nombre HTTPS estable para el proxy.	ninguno
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	Direcciones o rangos de proxies que pueden enviar cabeceras de identidad, separados por comas.	ninguno
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	Los nombres nuevos que llegan del proxy entran como miembros que solo pueden pedir.	false

Una configuración incorrecta impide que HolyArrs se inicie. Los pasos están en Inicio de sesión y contraseñas.

Para expertos

Metadatos

Variable	Qué hace	Predeterminado
HOLYARRS_METADATA_URL	La dirección del servidor de metadatos.	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	Tu propio token de acceso de lectura de TMDB. Si la defines, las lecturas de TMDB van directo a TMDB en vez de al servidor de metadatos.	ninguno
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	Archivo con la credencial de esta instalación para el servidor de metadatos, que se lee en cada llamada. Sin definir, la credencial vive en la bóveda.	ninguno

Atajos para el primer inicio

Cada una añade un elemento al iniciar. Se usan para demos y pruebas; el asistente del primer inicio hace lo mismo.

Variable	Añade
HOLYARRS_MOVIES	Una carpeta de la Biblioteca para películas.
HOLYARRS_QBITTORRENT_URL	Un gestor de descargas qBittorrent.
HOLYARRS_SOURCE_URL	Una Fuente Torznab sin clave.

Variables para desarrollo y pruebas

Apuntan HolyArrs a sustitutos para las pruebas. Déjalas sin definir en una instalación real.

Variable	Qué hace
HOLYARRS_FLAGS	Interruptores, separados por comas, para funciones que vienen desactivadas de forma predeterminada en esta versión. Consulta Actualizaciones.
HOLYARRS_DIRECT_SOURCES	1 deja que esta instalación consulte por su cuenta las fuentes de música y TV en vez de pasar por el servidor de metadatos.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	Permite un servidor de metadatos en la red local.
HOLYARRS_METADATA_COUNT	Cuenta las solicitudes de metadatos y las anota en el registro.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	Archivo de token de TMDB de prueba y dirección sustituta.
HOLYARRS_TVMAZE_URL, HOLYARRS_MUSICBRAINZ_URL, HOLYARRS_DEEZER_URL, HOLYARRS_TRAKT_URL, HOLYARRS_PLEX_URL, HOLYARRS_PLEX_APP_URL, HOLYARRS_PLEX_DISCOVER_URL, HOLYARRS_PUSHOVER_URL, HOLYARRS_TELEGRAM_URL, HOLYARRS_YOUTUBE_URL, HOLYARRS_RELEASE_FEED	Direcciones sustitutas de servicios externos.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	Tiempos de la pasada de tráileres, como duraciones; por ejemplo 2s.

Relacionado

• Instalar
• Ejecutar bajo una ruta
• Inicio de sesión y contraseñas