NAS, Synology a Unraid

Spusti HolyArrs na svojom NAS so správnymi priečinkami, vlastníkom a nastavením reštartu. Najprv si prečítaj Inštalácia.

Skôr než začneš

• /config patrí na lokálny volume alebo pool. Nikdy na sieťové zdieľanie.
• Médiá patria do jedného spoločného priečinka s downloads, movies, tv a music vo vnútri. Pripoj každý zvlášť, alebo raz nadradený priečinok kvôli hardlinkom (pevným odkazom). Pozri Priečinky.

Nastav svoj NAS

::tab[Synology]

1. Vo File Station vytvor docker/holyarrs/config.
2. Vytvor jeden zdieľaný priečinok media s downloads, movies, tv a music vo vnútri.
3. V Container Manager otvor Project > Create (projekt > vytvoriť) a vlož súbor Compose z Inštalácia.
4. Nastav volumes na /volume1/docker/holyarrs/config:/config, potom /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music a /volume1/media/downloads:/downloads.
5. Nastav PUID a PGID na svojho používateľa, často 1026 a 100. Over to cez id <user> po SSH.
6. Daj tomuto používateľovi čítanie a zápis na media: Control Panel > Shared Folder > Edit > Permissions (ovládací panel > zdieľaný priečinok > upraviť > oprávnenia).
7. Zaškrtni Enable auto-restart (zapnúť automatický reštart).
8. Otvor http://your-server:6262. Mal by si vidieť sprievodcu prvého spustenia. Pridaj /movies, /tv a /music ako priečinky knižnice.

::tab[Unraid]

Šablóna Community Applications zatiaľ neexistuje, preto pridaj kontajner ručne.

1. Na karte Docker pridaj kontajner s image HolyArrs.
2. Namapuj port 6262.
3. Namapuj /config na cestu v poole, napríklad /mnt/<pool>/appdata/holyarrs. <pool> je názov tvojho poolu. Nie /mnt/user/appdata.
4. Namapuj svoje priečinky s médiami na /movies, /tv, /music a /downloads pomocou ciest na disk alebo pool, napríklad /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music a /mnt/<pool>/media/downloads:/downloads.
5. Nastav PUID=99, PGID=100 (nobody:users v Unraide) a UMASK=022.
6. Zapni automatické spúšťanie kontajnera, aby sa sám reštartoval.
7. Otvor http://your-server:6262. Mal by si vidieť sprievodcu prvého spustenia.

::tab[QNAP]

1. Vytvor Container/holyarrs/config a jedno zdieľanie media s downloads, movies, tv a music vo vnútri.
2. V Container Station otvor Applications > Create (aplikácie > vytvoriť) a vlož súbor Compose.
3. Použi /share/Container/holyarrs/config:/config, potom /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music a /share/media/downloads:/downloads.
4. Nastav PUID a PGID na vlastníka zdieľania media.
5. Nastav politiku reštartu na unless-stopped.
6. Otvor http://your-server:6262. Mal by si vidieť sprievodcu prvého spustenia.

::tab[TrueNAS SCALE]

1. Vytvor 2 datasety: apps/holyarrs-config a media, s priečinkami downloads, movies, tv a music vo vnútri media.
2. V Apps pridaj vlastnú aplikáciu z YAML so súborom Compose.
3. Použi /mnt/<pool>/apps/holyarrs-config:/config, potom /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music a /mnt/<pool>/media/downloads:/downloads.
4. Nastav PUID a PGID na vlastníka datasetu, často 568. Daj tomuto používateľovi prístup na zápis v ACL datasetu.
5. Nastav politiku reštartu na unless-stopped.
6. Otvor http://your-server:6262. Mal by si vidieť sprievodcu prvého spustenia.

Na každom NAS: daj používateľovi PUID čítanie a zápis na priečinok s médiami na obrazovke oprávnení NAS; o konfiguračný priečinok sa HolyArrs postará sám. Zapni automatický reštart kontajnera (politika unless-stopped v Dockeri).

Pre hardlinky, ktoré nezaberú extra miesto a dokončia sa okamžite, pripoj jeden priečinok s médiami namiesto štyroch a daj svojmu sťahovaču rovnaké pripojenie na rovnakej ceste. Pozri Priečinky s médiami.

Možnosti

Samostatné pripojenia

Pripájanie /movies, /tv, /music a /downloads po jednom funguje, ale každý import sa stane úplnou kópiou. Každé pripojenie je vo vnútri kontajnera vlastný súborový systém a hardlink cez súborové systémy nejde. Samostatné zdieľania alebo datasety pod jedným nadradeným priečinkom sa tiež kopírujú. Settings > Library folders (nastavenia > priečinky knižnice) varuje, keď HolyArrs musí kopírovať.

Nechaj disky spať

Tieto úlohy budia disky s médiami. Ako často bežia, zmeníš na stránke Schedules (plány).

Úloha	Čo číta
Rescan the Library (znova prehľadať knižnicu)	Každý priečinok knižnice. Budí disky najviac.
Check Library folders (skontrolovať priečinky knižnice)	Údaje každého priečinka a voľné miesto. Test zápisu a hardlinku beží iba pri spustení, pri Run now (spustiť teraz) a pri zmene priečinkov.
Look for missing subtitles, Look for better subtitles (hľadať chýbajúce titulky, hľadať lepšie titulky)	Priečinok vedľa každého videa.

• Daj /config a priečinok sťahovania na SSD alebo cache pool.
• Nechaj 1 GB voľných na disku, kde je /config. Pod touto hranicou dostaneš varovanie o zdraví.
• V Unraide plugin Cache Directories drží zoznamy priečinkov v pamäti, takže skenovanie disk preskočí.
• Importy, pridávanie a mazanie sa dotknú disku, na ktorom pracujú, keď nastanú.
• Nastav opätovné prehľadávanie na každých 7 dní alebo vypni. Súbory pridané ručne sa potom nájdu až po kliknutí na Run now pri Rescan the Library.
• Seedujúci torrent číta svoj súbor. Ak je hardlinkom prepojený do tvojej knižnice, ten disk zostane hore, kým seedovanie neskončí.

Ak to nefunguje

Príznak	Príčina	Riešenie
Nespustí sa, spomína cestu FUSE, sieťové zdieľanie alebo používateľské zdieľanie Unraidu	/config nie je na lokálnom disku (v Unraide ukazuje na /mnt/user)	Presuň /config na lokálny disk alebo cestu v poole, napríklad /mnt/<pool>/appdata/holyarrs.
Po reštarte alebo obnove zostane zastavený	Automatický reštart je vypnutý	Zapni ho a spusti kontajner.
Importy zlyhávajú s chybou oprávnenia	Používateľ PUID nemôže zapisovať do médií	Daj mu čítanie a zápis na obrazovke oprávnení NAS (na Synology: Control Panel > Shared Folder > Edit > Permissions).
Importy sú kópie, nie hardlinky	Sťahovania a knižnica sú na rôznych pripojeniach alebo diskoch	Pripoj jeden spoločný priečinok raz, v HolyArrs aj v sťahovači.

Ďalšie riešenia: Riešenie problémov.

Pre expertov

Prečo HolyArrs odmieta niektoré cesty konfigurácie

HolyArrs drží svoje databázy v /config. Sieťové zdieľania a cesty FUSE môžu databázy poškodiť, preto sa HolyArrs na nich odmietne spustiť a povie prečo.

V Unraide je /mnt/user cesta FUSE. Použi cestu v poole alebo nastav appdata ako Exclusive: zapni Permit exclusive shares v Settings > Global Share Settings a potom nastav Shares > appdata na primárne úložisko na jednom poole a sekundárne úložisko na none.

Cesta /config na poole, ktorý neexistuje, skončí v pamäti a po reštarte sa stratí. HolyArrs odmietne aj to. Vyhni sa /mnt/user aj pre médiá; hardlinky cez ňu môžu zlyhať.

Prečo na automatickom reštarte záleží

Reštart v aplikácii, núdzový režim aj obnova zálohy HolyArrs zastavia a očakávajú, že ho Docker spustí znova. Bez automatického reštartu zostane zastavený. Pozri Časti a núdzový režim.

Port a aktualizácie

• Namapuj port 6262 iba na svoju domácu sieť. Prečítaj si Základy zabezpečenia, než ho otvoríš komukoľvek zvonku.
• Aktualizuješ tak, že stiahneš nový image a znova vytvoríš kontajner. Tvoje dáta zostanú v /config. Pozri Aktualizácie.

Súvisiace stránky

• Priečinky
• Priečinky knižnice
• Plány