Подешавање

Изгради HolyArrs из извора и отвори га у претраживачу на порту 6262.

Пре него што почнеш

• Go, у верзији коју наводи go.mod.
• Node 24 и npm.
• Терминал у корену репоа.

C compiler ти не треба. Build користи CGO_ENABLED=0.

Изгради и покрени

1. Инсталирај пакете веб апликације:

   npm --prefix app/frontend ci

2. Изгради веб апликацију:

   npm --prefix app/frontend run build

   Требало би да видиш да се build завршава и да се app/frontend/dist пуни фајловима.

3. Изгради програм:

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

4. Покрени га са својим конфигурационим фолдером:

   ./bin/holyarrs -config ./config

5. Отвори http://localhost:6262.

   Требало би да видиш чаробњак за прво покретање. Направи налог власника.

Caution

Програм уграђује app/frontend/dist. После измене веб апликације, поново изгради веб апликацију пре програма, иначе добијаш старе странице.

-config прима фолдер на локалном диску и подразумевано је /config. -addr мења адресу на којој програм слуша и подразумевано је :6262.

Рад на веб апликацији

Остави програм да ради. У другом терминалу покрени dev сервер:

npm --prefix app/frontend run dev

Dev сервер се поново учитава при чувању и шаље API позиве програму који ради. Требало би да видиш своју измену у претраживачу за 2 секунде.

Опције

Користи Makefile

Команда	Ради
make ui	Инсталира веб пакете и гради веб апликацију
make build	make ui, па гради bin/holyarrs
make test	go test са временским ограничењем од 25 мин
make vet	go vet ./...
make docker	Гради image као holyarrs:dev
make e2e	Покреће end-to-end тестове

Укључи задржану функцију

Неке функције су задржане и остају искључене. Наведи их у HOLYARRS_FLAGS, раздвојене зарезом:

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

Странице крију функцију која је искључена, а њене руте не постоје. Корисници читају о њима на страници Задржане функције.

Напуни Библиотеку демо подацима

Демо алат пуни конфигурациони фолдер демо колекцијом. Ради само док је HolyArrs заустављен и само на фолдеру који си означио као лабораторију. Означи га једном:

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

Затим seed -config ./config додаје демо библиотеку, а seed -config ./config -reset-demo уклања само оно што је додао. Медија фолдер мора бити /data/media осим ако проследиш -force. Dev алати остају ван image-а. Погледај Dev алати.

Ако не ради

Симптом. Странице изгледају старо пошто си променио веб апликацију. Узрок. Програм служи build који је уградио. Решење. Покрени веб build, па Go build, па покрени програм.

Симптом. go build пада због недостајућег app/frontend/dist. Узрок. Веб апликација још није изграђена. Решење. Прво покрени корак 2.

Симптом. Програм каже да је порт заузет. Узрок. Други HolyArrs или апликација држи 6262. Решење. Проследи другу адресу: ./bin/holyarrs -config ./config -addr :6263.

За напредне

Прекидачи задржаних функција

Прекидач	Функција
row_title_stats	Статистика редова на Explore за власника
trakt_lists	Trakt листе
alert_channels_more	Канали за обавештења поред Discord-а и имејла
subtitle_sites	Сајтови за титлове и претрага титлова
emby_signin	Пријава преко Emby-ја
go_back	Кораци за повратак на претходну верзију

Да додаш један, региструј његово име са startup.RegisterFeature и провери startup.FeatureOn пре него што региструјеш његове руте. Имена су у app/backend/internal/core/startup (feature.go).

Dev алати

Алат	Команда	Ради
Demo	go run ./app/backend/tools/demo <command> -config DIR	Ради на заустављеном конфигурационом фолдеру. Команде: inspect (бројеви), fingerprint, query "SELECT ..." (само за читање), doctor, seed, showcase
Лажни сајт за титлове	go run ./app/backend/tools/fakesubs	Служи лажне сајтове за титлове за тестове на 127.0.0.1:18727. -addr га помера; -accounts-addr додаје лажне сајтове са налозима
Листа рута	go run ./app/backend/tools/apidoc	Поново пише API руте

Изгради image

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

Image почиње FROM scratch и садржи програм, CA сертификате и лиценце. Покреће -config /config -addr :6262.

Повезане странице

• Доприношење
• Тестирање
• Модули