Postavljanje

Izgradi HolyArrs iz izvornog koda i otvori ga u pregledniku na portu 6262.

Prije nego počneš

• Go, u verziji koju navodi go.mod.
• Node 24 i npm.
• Terminal u korijenu repozitorija.

C compiler ti ne treba. Buildovi koriste CGO_ENABLED=0.

Izgradi i pokreni

1. Instaliraj pakete web aplikacije:

   npm --prefix app/frontend ci

2. Izgradi web aplikaciju:

   npm --prefix app/frontend run build

   Vidjet ćeš da se build završi i da se app/frontend/dist napuni datotekama.

3. Izgradi program:

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

4. Pokreni ga s vlastitom mapom s konfiguracijom:

   ./bin/holyarrs -config ./config

5. Otvori http://localhost:6262.

   Vidjet ćeš čarobnjak za prvo pokretanje. Napravi račun vlasnika.

Caution

Program ugrađuje app/frontend/dist. Nakon promjene web aplikacije ponovno izgradi web aplikaciju prije programa, inače dobiješ stare stranice.

-config prima mapu na lokalnom disku i prema zadanim postavkama je /config. -addr mijenja adresu na kojoj program sluša i prema zadanim postavkama je :6262.

Radi na web aplikaciji

Ostavi program pokrenut. U drugom terminalu pokreni dev server:

npm --prefix app/frontend run dev

Dev server se ponovno učitava pri spremanju i šalje API pozive pokrenutom programu. Svoju izmjenu vidjet ćeš u pregledniku unutar 2 s.

Izbori

Koristi Makefile

Naredba	Radi
make ui	Instalira web pakete i gradi web aplikaciju
make build	make ui, zatim gradi bin/holyarrs
make test	go test s ograničenjem od 25 min
make vet	go vet ./...
make docker	Gradi image kao holyarrs:dev
make e2e	Pokreće end-to-end testove

Uključi zadržanu značajku

Neke značajke su zadržane i ostaju isključene. Navedi ih u HOLYARRS_FLAGS, odvojene zarezom:

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

Stranice skrivaju isključenu značajku, a njezine rute ne postoje. Korisnici o njima čitaju u Zadržanim značajkama.

Napuni biblioteku demo podacima

Demo alat puni mapu s konfiguracijom demo zbirkom. Radi samo na zaustavljenom HolyArrs-u i samo na mapi označenoj kao lab. Označi je jednom:

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

Zatim seed -config ./config dodaje demo biblioteku, a seed -config ./config -reset-demo uklanja samo ono što je dodao. Mapa s medijima mora biti /data/media osim ako ne predaš -force. Dev alati ostaju izvan imagea. Vidi Dev alati.

Ako ne radi

Simptom. Stranice izgledaju staro nakon promjene web aplikacije. Uzrok. Program poslužuje build koji je ugradio. Rješenje. Pokreni web build, zatim Go build, pa pokreni program.

Simptom. go build ne uspijeva jer nedostaje app/frontend/dist. Uzrok. Web aplikacija još nije izgrađena. Rješenje. Prvo izvrši korak 2.

Simptom. Program kaže da je port zauzet. Uzrok. Drugi HolyArrs ili neka aplikacija drži 6262. Rješenje. Predaj drugu adresu: ./bin/holyarrs -config ./config -addr :6263.

Za napredne

Prekidači zadržanih značajki

Prekidač	Značajka
row_title_stats	Statistika redova na Istraži za vlasnika
trakt_lists	Trakt popisi
alert_channels_more	Kanali za obavijesti osim Discorda i e-pošte
subtitle_sites	Stranice s titlovima i pretraživanje titlova
emby_signin	Prijava preko Embyja
go_back	Koraci za povratak na prethodnu verziju

Da dodaš novi, registriraj njegovo ime s startup.RegisterFeature i provjeri startup.FeatureOn prije registracije njegovih ruta. Imena su u app/backend/internal/core/startup (feature.go).

Dev alati

Alat	Naredba	Radi
Demo	go run ./app/backend/tools/demo <command> -config DIR	Radi na zaustavljenoj mapi s konfiguracijom. Naredbe: inspect (brojevi), fingerprint, query "SELECT ..." (samo čitanje), doctor, seed, showcase
Lažna stranica s titlovima	go run ./app/backend/tools/fakesubs	Poslužuje lažne stranice s titlovima za testove na 127.0.0.1:18727. -addr ga pomiče; -accounts-addr dodaje lažne stranice s računima
Popis ruta	go run ./app/backend/tools/apidoc	Ponovno piše API rute

Izgradi image

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

Image kreće od FROM scratch i sadrži program, CA certifikate i licence. Pokreće -config /config -addr :6262.

Povezane stranice

• Doprinos
• Testiranje
• Moduli