NAS, Synology at Unraid

Patakbuhin ang HolyArrs sa NAS mo na may tamang mga folder, owner at setting ng restart. Basahin muna ang I-install.

Bago ka magsimula

• Ang /config ay nasa lokal na volume o pool. Huwag kailanman sa network share.
• Ang media ay nasa isang shared na folder na may downloads, movies, tv at music sa loob. I-mount ang bawat isa, o ang parent nang isang beses para sa mga hardlink (isang pangalan para sa parehong file). Tingnan ang Mga folder.

I-set up ang NAS mo

::tab[Synology]

1. Sa File Station, gawin ang docker/holyarrs/config.
2. Gumawa ng isang shared folder na media na may downloads, movies, tv at music sa loob.
3. Sa Container Manager, buksan ang Project > Create at i-paste ang Compose file mula sa I-install.
4. Itakda ang mga volume sa /volume1/docker/holyarrs/config:/config, saka /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music at /volume1/media/downloads:/downloads.
5. Itakda ang PUID at PGID sa user mo, madalas 1026 at 100. Tingnan gamit ang id <user> sa SSH.
6. Bigyan ang user na iyon ng read at write sa media: Control Panel > Shared Folder > Edit > Permissions.
7. Lagyan ng tsek ang Enable auto-restart.
8. Buksan ang http://your-server:6262. Dapat makita mo ang wizard ng unang takbo. Idagdag ang /movies, /tv at /music bilang mga folder ng Aklatan.

::tab[Unraid]

Wala pang template sa Community Applications, kaya idagdag ang container nang mano-mano.

1. Sa Docker tab, magdagdag ng container gamit ang HolyArrs image.
2. I-map ang port 6262.
3. I-map ang /config sa path ng pool, gaya ng /mnt/<pool>/appdata/holyarrs. Ang <pool> ay ang pangalan ng pool mo. Huwag ang /mnt/user/appdata.
4. I-map ang mga media folder mo sa /movies, /tv, /music at /downloads, gamit ang mga path ng disk o pool, halimbawa /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music at /mnt/<pool>/media/downloads:/downloads.
5. Itakda ang PUID=99, PGID=100 (ang nobody:users ng Unraid) at UMASK=022.
6. I-on ang auto-start para sa container, para kusa itong mag-restart.
7. Buksan ang http://your-server:6262. Dapat makita mo ang wizard ng unang takbo.

::tab[QNAP]

1. Gawin ang Container/holyarrs/config at isang media share na may downloads, movies, tv at music sa loob.
2. Sa Container Station, buksan ang Applications > Create at i-paste ang Compose file.
3. Gamitin ang /share/Container/holyarrs/config:/config, saka /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music at /share/media/downloads:/downloads.
4. Itakda ang PUID at PGID sa owner ng media share.
5. Itakda ang restart policy sa unless-stopped.
6. Buksan ang http://your-server:6262. Dapat makita mo ang wizard ng unang takbo.

::tab[TrueNAS SCALE]

1. Gumawa ng 2 dataset: apps/holyarrs-config at media, na may mga folder na downloads, movies, tv at music sa loob ng media.
2. Sa Apps, magdagdag ng custom app mula sa YAML gamit ang Compose file.
3. Gamitin ang /mnt/<pool>/apps/holyarrs-config:/config, saka /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music at /mnt/<pool>/media/downloads:/downloads.
4. Itakda ang PUID at PGID sa owner ng dataset, madalas 568. Bigyan ang user na iyon ng permiso sa pagsulat sa ACL ng dataset.
5. Itakda ang restart policy sa unless-stopped.
6. Buksan ang http://your-server:6262. Dapat makita mo ang wizard ng unang takbo.

Sa bawat NAS: bigyan ang user ng PUID ng read at write sa media folder sa screen ng mga permiso ng NAS; ang HolyArrs na ang bahala sa config folder. I-on ang auto-restart para sa container (ang unless-stopped policy ng Docker).

Para sa mga hardlink, na walang dagdag na espasyo at natatapos kaagad, i-mount ang isang media folder sa halip na ang apat, at ibigay sa downloader mo ang parehong mount sa parehong path. Tingnan ang Mga media folder.

Mga pagpipilian

Hiwalay na mga mount

Gumagana ang pag-mount ng /movies, /tv, /music at /downloads nang isa-isa, pero nagiging buong kopya ang bawat import. Sariling filesystem ang bawat mount sa loob ng container, at hindi nakakatawid ng filesystem ang hardlink. Kinokopya rin ang mga hiwalay na share o dataset sa ilalim ng isang parent. Nagbababala ang Settings > Library folders kapag kailangang kopyahin ng HolyArrs ang mga file.

Hayaang matulog ang mga disk mo

Ginigising ng mga gawaing ito ang mga media disk. Baguhin kung gaano kadalas tumatakbo ang mga ito sa Schedules page.

Gawain	Ano ang binabasa nito
Rescan the Library (i-scan ulit ang Aklatan)	Bawat folder ng Aklatan. Ito ang pinakamadalas gumising ng mga disk.
Check Library folders (suriin ang mga folder ng Aklatan)	Mga detalye at libreng espasyo ng bawat folder. Ang write at hardlink test ay tumatakbo lang sa pagsisimula, sa Run now at kapag nagbago ang mga folder.
Look for missing subtitles, Look for better subtitles	Ang folder sa tabi ng bawat video.

• Ilagay ang /config at ang download folder sa SSD o cache pool.
• Magtabi ng 1 GB na libre sa disk na may /config. Kapag mas mababa rito, makakakuha ka ng babala sa kalusugan.
• Sa Unraid, itinatago ng Cache Directories plugin ang mga listahan ng folder sa memory, kaya nilalampasan ng mga scan ang disk.
• Ang mga import, pagdaragdag at pagbura ay humahawak sa disk na ginagamit nila, kapag nangyari ang mga ito.
• Itakda ang rescan sa kada 7 araw o i-off. Ang mga file na idinagdag mo nang mano-mano ay mahahanap lang kapag pinindot mo ang Run now sa Rescan the Library.
• Binabasa ng seeding na torrent ang file nito. Kung naka-hardlink ito sa Aklatan mo, mananatiling gising ang disk na iyon hanggang tumigil ang seeding.

Kung hindi gumana

Sintomas	Dahilan	Solusyon
Ayaw magsimula, pinangalanan ang FUSE path, network share o user share ng Unraid	Wala sa lokal na disk ang /config (sa Unraid, nakaturo ito sa /mnt/user)	Ilipat ang /config sa lokal na disk o path ng pool, gaya ng /mnt/<pool>/appdata/holyarrs.
Nananatiling nakahinto pagkatapos ng restart o restore	Naka-off ang auto-restart	I-on ito at simulan ang container.
Pumapalya ang mga import dahil sa error sa permiso	Hindi makasulat ang user ng PUID sa media	Bigyan ito ng read at write sa screen ng mga permiso ng NAS (sa Synology: Control Panel > Shared Folder > Edit > Permissions).
Mga kopya ang mga import, hindi mga hardlink	Nasa magkaibang mount o disk ang Downloads at Aklatan	I-mount ang isang shared na folder nang isang beses, sa HolyArrs at sa downloader.

Higit pang ayos: Pag-troubleshoot.

Para sa mga eksperto

Bakit tinatanggihan ng HolyArrs ang ilang config path

Itinatago ng HolyArrs ang mga database nito sa /config. Maaaring masira ng mga network share at FUSE path ang mga ito, kaya tumatangging magsimula ang HolyArrs sa isa at sinasabi kung bakit.

Sa Unraid, FUSE path ang /mnt/user. Gumamit ng path ng pool, o gawing Exclusive ang appdata: i-on ang Permit exclusive shares sa Settings > Global Share Settings, saka itakda ang Shares > appdata sa primary storage sa isang pool at secondary storage sa none.

Ang /config path sa pool na hindi umiiral ay napupunta sa memory at nawawala sa reboot. Tinatanggihan din iyon ng HolyArrs. Iwasan din ang /mnt/user para sa media; maaaring pumalya ang mga hardlink na dumadaan dito.

Bakit mahalaga ang auto-restart

Ang restart sa app, safe mode at pag-restore ng backup ay pawang humihinto sa HolyArrs at umaasang sisimulan ulit ito ng Docker. Kung walang auto-restart, mananatili itong nakahinto. Tingnan ang Mga bahagi at safe mode.

Port at mga update

• I-map ang port 6262 sa home network mo lang. Basahin ang Mga pangunahing kaalaman sa seguridad bago ito buksan sa sinuman sa labas.
• Para mag-update, i-pull ang bagong image at gawing muli ang container. Nananatili ang data mo sa /config. Tingnan ang Mga update.

Kaugnay

• Mga folder
• Mga folder ng Aklatan
• Mga iskedyul