Configuración

Compila HolyArrs desde el código fuente y ábrelo en tu navegador en el puerto 6262.

Antes de empezar

• Go, en la versión que indica go.mod.
• Node 24 y npm.
• Una terminal en la raíz del repositorio.

No necesitas un compilador de C. Las compilaciones usan CGO_ENABLED=0.

Compila y ejecuta

1. Instala los paquetes de la app web:

   npm --prefix app/frontend ci

2. Compila la app web:

   npm --prefix app/frontend run build

   Deberías ver que la compilación termina y que app/frontend/dist se llena de archivos.

3. Compila el programa:

   go build -o bin/holyarrs ./app/backend/cmd/holyarrs

4. Ejecútalo con una carpeta de configuración propia:

   ./bin/holyarrs -config ./config

5. Abre http://localhost:6262.

   Deberías ver el asistente de primer inicio. Crea la cuenta de propietario.

Precaución

El programa incorpora app/frontend/dist. Después de un cambio en la app web, vuelve a compilar la app web antes que el programa, o verás las páginas antiguas.

-config recibe una carpeta en un disco local y de forma predeterminada es /config. -addr cambia la dirección de escucha y de forma predeterminada es :6262.

Trabaja en la app web

Deja el programa en ejecución. En una segunda terminal, inicia el servidor de desarrollo:

npm --prefix app/frontend run dev

El servidor de desarrollo recarga al guardar y envía las llamadas a la API al programa en ejecución. Deberías ver tu cambio en el navegador en menos de 2 s.

Opciones

Usa el Makefile

Comando	Qué hace
make ui	Instala los paquetes web y compila la app web
make build	make ui, y luego compila bin/holyarrs
make test	go test con un tiempo límite de 25 min
make vet	go vet ./...
make docker	Compila la imagen como holyarrs:dev
make e2e	Ejecuta las pruebas de extremo a extremo

Activa una función retenida

Algunas funciones están retenidas y siguen desactivadas. Nómbralas en HOLYARRS_FLAGS, separadas por comas:

HOLYARRS_FLAGS=subtitle_sites,ai_apps ./bin/holyarrs -config ./config

Las páginas ocultan una función que está desactivada, y sus rutas no existen. Los usuarios leen sobre ellas en Funciones retenidas.

Llena la Biblioteca con datos de demostración

La herramienta de demostración llena una carpeta de configuración con una colección de demostración. Funciona solo con HolyArrs detenido y solo en una carpeta que marcaste como laboratorio. Márcala una vez:

go run ./app/backend/tools/demo seed -config ./config -init-lab

Después, seed -config ./config añade la biblioteca de demostración y seed -config ./config -reset-demo quita solo lo que añadió. La carpeta de medios debe ser /data/media, salvo que pases -force. Las herramientas de desarrollo se quedan fuera de la imagen. Consulta Herramientas de desarrollo.

Si no funciona

Síntoma. Las páginas se ven antiguas después de cambiar la app web. Causa. El programa sirve la compilación que incorporó. Solución. Ejecuta la compilación web, luego la de Go, y después inicia el programa.

Síntoma. go build falla porque falta app/frontend/dist. Causa. La app web todavía no está compilada. Solución. Ejecuta primero el paso 2.

Síntoma. El programa dice que el puerto está en uso. Causa. Otro HolyArrs u otra app ocupa 6262. Solución. Pasa otra dirección: ./bin/holyarrs -config ./config -addr :6263.

Para expertos

Interruptores de funciones retenidas

Interruptor	Función
plex_watchlists	Las listas de seguimiento de Plex se convierten en solicitudes
row_title_stats	Estadísticas de las filas de Explorar para el propietario
trakt_lists	Listas de Trakt
alert_channels_more	Canales de avisos además de Discord y email
subtitle_sites	Sitios de subtítulos y búsqueda de subtítulos
emby_signin	Iniciar sesión con Emby
go_back	Pasos para volver a la versión anterior

Para añadir uno, registra su nombre con startup.RegisterFeature y comprueba startup.FeatureOn antes de registrar sus rutas. Los nombres están en app/backend/internal/core/startup (feature.go).

Herramientas de desarrollo

Herramienta	Comando	Qué hace
Demostración	go run ./app/backend/tools/demo <command> -config DIR	Trabaja sobre una carpeta de configuración detenida. Comandos: inspect (recuentos), fingerprint, query "SELECT ..." (solo lectura), doctor, seed, showcase
Sitio de subtítulos falso	go run ./app/backend/tools/fakesubs	Sirve sitios de subtítulos falsos para las pruebas en 127.0.0.1:18727. -addr lo mueve; -accounts-addr añade los sitios de cuentas falsos
Lista de rutas	go run ./app/backend/tools/apidoc	Vuelve a generar Rutas de la API

Compila la imagen

docker build --file deploy/Dockerfile --tag holyarrs:dev .
docker run -p 6262:6262 -v ./config:/config holyarrs:dev

La imagen empieza con FROM scratch y contiene el programa, los certificados de CA y las licencias. Ejecuta -config /config -addr :6262.

Relacionado

• Contribuir
• Pruebas
• Módulos