Configurare

Construiește HolyArrs din sursă și deschide-l în browser pe portul 6262.

Înainte să începi

• Go, la versiunea pe care o numește go.mod.
• Node 24 și npm.
• Un terminal în rădăcina depozitului.

Nu ai nevoie de compilator C. Build-urile folosesc CGO_ENABLED=0.

Construiește și rulează

1. Instalează pachetele aplicației web:

   npm --prefix app/frontend ci

2. Construiește aplicația web:

   npm --prefix app/frontend run build

   Ar trebui să vezi build-ul terminându-se și app/frontend/dist umplându-se cu fișiere.

3. Construiește programul:

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

4. Rulează-l cu un dosar de configurare al tău:

   ./bin/holyarrs -config ./config

5. Deschide http://localhost:6262.

   Ar trebui să vezi asistentul de la prima pornire. Creează contul de proprietar.

Atenție

Programul include app/frontend/dist. După o schimbare în aplicația web, construiește din nou aplicația web înaintea programului, altfel vezi paginile vechi.

-config primește un dosar de pe discul local și are implicit /config. -addr schimbă adresa pe care ascultă și are implicit :6262.

Lucrează la aplicația web

Lasă programul pornit. Într-un al doilea terminal, pornește serverul de dezvoltare:

npm --prefix app/frontend run dev

Serverul de dezvoltare se reîncarcă la salvare și trimite apelurile API spre programul care rulează. Ar trebui să vezi schimbarea în browser în 2 s.

Alegeri

Folosește Makefile

Comandă	Face
make ui	Instalează pachetele web și construiește aplicația web
make build	make ui, apoi construiește bin/holyarrs
make test	go test cu limită de 25 min
make vet	go vet ./...
make docker	Construiește imaginea ca holyarrs:dev
make e2e	Rulează testele end-to-end

Pornește o funcție reținută

Unele funcții sunt reținute și rămân oprite. Numește-le în HOLYARRS_FLAGS, separate prin virgulă:

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

Paginile ascund o funcție oprită, iar rutele ei nu există. Utilizatorii citesc despre ele în Funcții reținute.

Umple Biblioteca cu date demo

Unealta demo umple un dosar de configurare cu o colecție demo. Merge doar pe un HolyArrs oprit și doar pe un dosar pe care l-ai marcat ca laborator. Marchează-l o dată:

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

Apoi seed -config ./config adaugă biblioteca demo, iar seed -config ./config -reset-demo șterge doar ce a adăugat. Dosarul media trebuie să fie /data/media, afară de cazul în care dai -force. Uneltele de dezvoltare rămân în afara imaginii. Vezi Unelte de dezvoltare.

Dacă nu merge

Simptom. Paginile arată vechi după ce ai schimbat aplicația web. Cauză. Programul servește build-ul pe care l-a inclus. Soluție. Rulează build-ul web, apoi build-ul Go, apoi pornește programul.

Simptom. go build eșuează din cauza lipsei app/frontend/dist. Cauză. Aplicația web nu e construită încă. Soluție. Rulează mai întâi pasul 2.

Simptom. Programul spune că portul e ocupat. Cauză. Alt HolyArrs sau altă aplicație ține 6262. Soluție. Dă altă adresă: ./bin/holyarrs -config ./config -addr :6263.

Pentru experți

Comutatoare pentru funcții reținute

Comutator	Funcție
row_title_stats	Statistici pe rândurile din Explore, pentru proprietar
trakt_lists	Liste Trakt
alert_channels_more	Canale de alerte în afară de Discord și email
subtitle_sites	Site-uri de subtitrări și căutare de subtitrări
emby_signin	Conectare cu Emby
go_back	Pași pentru a reveni la versiunea veche

Ca să adaugi unul, înregistrează-i numele cu startup.RegisterFeature și verifică startup.FeatureOn înainte să îi înregistrezi rutele. Numele stau în app/backend/internal/core/startup (feature.go).

Unelte de dezvoltare

Unealtă	Comandă	Face
Demo	go run ./app/backend/tools/demo <command> -config DIR	Lucrează pe un dosar de configurare oprit. Comenzi: inspect (numărători), fingerprint, query "SELECT ..." (doar citire), doctor, seed, showcase
Site fals de subtitrări	go run ./app/backend/tools/fakesubs	Servește site-uri false de subtitrări pentru teste pe 127.0.0.1:18727. -addr îl mută; -accounts-addr adaugă site-urile false cu conturi
Lista de rute	go run ./app/backend/tools/apidoc	Rescrie Rutele API

Construiește imaginea

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

Imaginea pornește FROM scratch și conține programul, certificatele CA și licențele. Rulează -config /config -addr :6262.

Vezi și

• Cum contribui
• Testare
• Module