NAS, Synology a Unraid

Spusť HolyArrs na svém NAS se správnými složkami, vlastníkem a nastavením restartu. Nejdřív si přečti Instalaci.

Než začneš

• /config patří na místní volume nebo pool. Nikdy na sdílenou složku po síti.
• Média patří do jedné sdílené složky, uvnitř které jsou downloads, movies, tv a music. Připoj každou zvlášť, nebo jednou nadřazenou složku kvůli hardlinkům (pevný odkaz). Viz Složky.

Nastav svůj NAS

::tab[Synology]

1. Ve File Station vytvoř docker/holyarrs/config.
2. Vytvoř jednu sdílenou složku media a uvnitř ní downloads, movies, tv a music.
3. V Container Manageru otevři Project > Create a vlož soubor Compose z Instalace.
4. Nastav volumy na /volume1/docker/holyarrs/config:/config, pak /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music a /volume1/media/downloads:/downloads.
5. Nastav PUID a PGID na svého uživatele, často 1026 a 100. Ověř si to přes SSH pomocí id <user>.
6. Dej tomuto uživateli čtení a zápis na media: Control Panel > Shared Folder > Edit > Permissions.
7. Zaškrtni Enable auto-restart.
8. Otevři http://your-server:6262. Měl bys vidět průvodce prvním spuštěním. Přidej /movies, /tv a /music jako složky knihovny.

::tab[Unraid]

Zatím tu není šablona v Community Applications, takže kontejner přidej ručně.

1. Na kartě Docker přidej kontejner s image HolyArrs.
2. Namapuj port 6262.
3. Namapuj /config na cestu v poolu, například /mnt/<pool>/appdata/holyarrs. <pool> je název tvého poolu. Ne /mnt/user/appdata.
4. Namapuj své složky s médii na /movies, /tv, /music a /downloads pomocí cest k disku nebo poolu, napří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 Unraidu) a UMASK=022.
6. Zapni pro kontejner automatický start, aby se sám restartoval.
7. Otevři http://your-server:6262. Měl bys vidět průvodce prvním spuštěním.

::tab[QNAP]

1. Vytvoř Container/holyarrs/config a jednu sdílenou složku media s downloads, movies, tv a music uvnitř.
2. V Container Station otevři Applications > Create a vlož soubor Compose.
3. Použij /share/Container/holyarrs/config:/config, pak /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 sdílené složky media.
5. Nastav zásadu restartu na unless-stopped.
6. Otevři http://your-server:6262. Měl bys vidět průvodce prvním spuštěním.

::tab[TrueNAS SCALE]

1. Vytvoř 2 datasety: apps/holyarrs-config a media, a uvnitř media složky downloads, movies, tv a music.
2. V Apps přidej vlastní aplikaci z YAML se souborem Compose.
3. Použij /mnt/<pool>/apps/holyarrs-config:/config, pak /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. Dej tomuto uživateli přístup pro zápis v ACL datasetu.
5. Nastav zásadu restartu na unless-stopped.
6. Otevři http://your-server:6262. Měl bys vidět průvodce prvním spuštěním.

U každého NAS: dej uživateli PUID čtení a zápis na složku s médii v obrazovce oprávnění NAS; o konfigurační složku se HolyArrs postará sám. Zapni pro kontejner automatický restart (zásada unless-stopped v Dockeru).

U hardlinků, které nezabírají místo navíc a dokončí se okamžitě, připoj jednu složku s médii místo čtyř a dej stahovači stejné připojení na stejné cestě. Viz Složky s médii.

Možnosti

Samostatná připojení

Připojování /movies, /tv, /music a /downloads jednotlivě funguje, ale každý import se pak stane plnou kopií. Každé připojení je uvnitř kontejneru vlastní souborový systém a hardlink nemůže přejít mezi souborovými systémy. Samostatné sdílené složky nebo datasety pod jednou nadřazenou složkou se taky kopírují. Settings > Library folders (Nastavení > Složky knihovny) varuje, když musí HolyArrs kopírovat.

Nech disky spát

Tyto úlohy disky s médii probouzejí. Jak často běží, změníš na stránce Schedules (plány).

Úloha	Co čte
Rescan the Library (znovu projít Knihovnu)	Každou složku knihovny. Disky probouzí nejvíc.
Check Library folders (zkontrolovat složky knihovny)	Údaje o každé složce a volné místo. Test zápisu a hardlinku běží jen při startu, při Run now (spustit hned) a při změně složek.
Look for missing subtitles, Look for better subtitles (hledat chybějící titulky, hledat lepší titulky)	Složku vedle každého videa.

• Dej /config a složku se stahováním na SSD nebo cache pool.
• Nech 1 GB volný na disku, kde leží /config. Pod tím dostaneš varování zdraví.
• V Unraidu plugin Cache Directories drží výpisy složek v paměti, takže procházení disk přeskočí.
• Importy, přidávání a mazání sáhnou na disk, se kterým pracují, ve chvíli, kdy se dějí.
• Nastav opětovné procházení na každých 7 dní, nebo ho vypni. Soubory, které přidáš ručně, se pak najdou až po kliknutí na Run now u Rescan the Library.
• Seedující torrent čte svůj soubor. Pokud je hardlinkem propojený do tvé knihovny, ten disk zůstane vzhůru, dokud seedování neskončí.

Když to nefunguje

Příznak	Příčina	Řešení
Nespustí se, jmenuje cestu FUSE, sdílenou složku po síti nebo uživatelskou sdílenou složku Unraidu	/config není na místním disku (v Unraidu míří na /mnt/user)	Přesuň /config na místní disk nebo cestu v poolu, například /mnt/<pool>/appdata/holyarrs.
Po restartu nebo obnově zůstane zastavený	Automatický restart je vypnutý	Zapni ho a spusť kontejner.
Importy selhávají s chybou oprávnění	Uživatel PUID nemůže zapisovat do médií	Dej mu čtení a zápis v obrazovce oprávnění NAS (na Synology: Control Panel > Shared Folder > Edit > Permissions).
Importy jsou kopie, ne hardlinky	Stahování a knihovna jsou na různých připojeních nebo discích	Připoj jednu sdílenou složku jednou, v HolyArrs i ve stahovači.

Další řešení: Řešení potíží.

Pro pokročilé

Proč HolyArrs odmítá některé cesty ke konfiguraci

HolyArrs drží své databáze v /config. Sdílené složky po síti a cesty FUSE je mohou poškodit, takže HolyArrs na takové cestě odmítne spuštění a řekne proč.

V Unraidu je /mnt/user cesta FUSE. Použij cestu v poolu, nebo udělej z appdata Exclusive: zapni Permit exclusive shares v Settings > Global Share Settings a pak nastav u Shares > appdata primární úložiště na jeden pool a sekundární úložiště na none.

Cesta /config na poolu, který neexistuje, skončí v paměti a po restartu se ztratí. I to HolyArrs odmítne. Vyhni se /mnt/user i pro média; hardlinky přes něj mohou selhat.

Proč záleží na automatickém restartu

Restart v aplikaci, nouzový režim i obnova zálohy HolyArrs zastaví a počítají s tím, že ho Docker znovu spustí. Bez automatického restartu zůstane zastavený. Viz Části a nouzový režim.

Port a aktualizace

• Namapuj port 6262 jen do své domácí sítě. Než ho otevřeš někomu zvenčí, přečti si Základy zabezpečení.
• Při aktualizaci stáhni nový image a vytvoř kontejner znovu. Data zůstávají v /config. Viz Aktualizace.

Související

• Složky
• Složky knihovny
• Plány