NAS, Synology och Unraid

Kör HolyArrs på din NAS med rätt mappar, ägare och omstartsinställning. Läs Installation först.

Innan du börjar

• /config läggs på en lokal volym eller pool. Aldrig en nätverksresurs.
• Media läggs i en gemensam mapp med downloads, movies, tv och music inuti. Montera var och en, eller den överordnade mappen en gång för hardlinks (hård länk). Se Mappar.

Konfigurera din NAS

::tab[Synology]

1. Skapa docker/holyarrs/config i File Station.
2. Skapa en delad mapp media med downloads, movies, tv och music inuti.
3. I Container Manager öppnar du Project > Create (projekt > skapa) och klistrar in Compose-filen från Installation.
4. Sätt volymerna till /volume1/docker/holyarrs/config:/config, sedan /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music och /volume1/media/downloads:/downloads.
5. Sätt PUID och PGID till din användare, ofta 1026 och 100. Kontrollera med id <user> över SSH.
6. Ge den användaren läs- och skrivrättigheter på media: Control Panel > Shared Folder > Edit > Permissions (kontrollpanel > delad mapp > redigera > behörigheter).
7. Bocka i Enable auto-restart (aktivera automatisk omstart).
8. Öppna http://your-server:6262. Du ska se guiden vid första start. Lägg till /movies, /tv och /music som biblioteksmappar.

::tab[Unraid]

Det finns ingen mall i Community Applications ännu, så lägg till containern för hand.

1. På fliken Docker lägger du till en container med HolyArrs-imagen.
2. Mappa porten 6262.
3. Mappa /config till en poolsökväg, till exempel /mnt/<pool>/appdata/holyarrs. <pool> är namnet på din pool. Inte /mnt/user/appdata.
4. Mappa dina mediamappar till /movies, /tv, /music och /downloads, med disk- eller poolsökvägar, till exempel /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music och /mnt/<pool>/media/downloads:/downloads.
5. Sätt PUID=99, PGID=100 (Unraids nobody:users) och UMASK=022.
6. Slå på autostart för containern, så att den startar om av sig själv.
7. Öppna http://your-server:6262. Du ska se guiden vid första start.

::tab[QNAP]

1. Skapa Container/holyarrs/config och en media-resurs med downloads, movies, tv och music inuti.
2. I Container Station öppnar du Applications > Create (program > skapa) och klistrar in Compose-filen.
3. Använd /share/Container/holyarrs/config:/config, sedan /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music och /share/media/downloads:/downloads.
4. Sätt PUID och PGID till ägaren av resursen media.
5. Sätt omstartspolicyn till unless-stopped.
6. Öppna http://your-server:6262. Du ska se guiden vid första start.

::tab[TrueNAS SCALE]

1. Skapa 2 datasets: apps/holyarrs-config och media, med mapparna downloads, movies, tv och music inuti media.
2. Under Apps lägger du till en egen app från YAML med Compose-filen.
3. Använd /mnt/<pool>/apps/holyarrs-config:/config, sedan /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music och /mnt/<pool>/media/downloads:/downloads.
4. Sätt PUID och PGID till datasetets ägare, ofta 568. Ge den användaren skrivrättigheter i datasetets ACL.
5. Sätt omstartspolicyn till unless-stopped.
6. Öppna http://your-server:6262. Du ska se guiden vid första start.

På varje NAS: ge PUID-användaren läs- och skrivrättigheter på mediamappen i NAS:ens behörighetsskärm; HolyArrs sköter konfigurationsmappen själv. Slå på automatisk omstart för containern (Dockers policy unless-stopped).

För hardlinks, som inte tar något extra utrymme och blir klara direkt, monterar du den enda mediamappen i stället för de fyra och ger din nedladdare samma montering på samma sökväg. Se Mediamappar.

Val

Separata monteringar

Att montera /movies, /tv, /music och /downloads en och en fungerar, men varje import blir en full kopia. Varje montering är ett eget filsystem inne i containern, och en hardlink kan inte gå mellan filsystem. Separata resurser eller datasets under en gemensam överordnad mapp kopierar också. Settings > Library folders (inställningar > biblioteksmappar) varnar när HolyArrs måste kopiera.

Låt dina diskar sova

De här jobben väcker mediadiskarna. Ändra hur ofta de körs på sidan Schedules (scheman).

Jobb	Vad det läser
Rescan the Library (sök igenom biblioteket igen)	Varje biblioteksmapp. Väcker diskarna mest.
Check Library folders (kontrollera biblioteksmappar)	Varje mapps uppgifter och ledigt utrymme. Skriv- och hardlink-testet körs bara vid start, vid Run now (kör nu) och när mappar ändras.
Look for missing subtitles (leta efter saknade undertexter), Look for better subtitles (leta efter bättre undertexter)	Mappen bredvid varje video.

• Lägg /config och nedladdningsmappen på en SSD eller cache-pool.
• Behåll 1 GB ledigt på disken som håller /config. Under det får du en hälsovarning.
• På Unraid håller pluginet Cache Directories mapplistor i minnet, så att genomsökningar hoppar över disken.
• Importer, tillägg och raderingar rör den disk de arbetar på, när de sker.
• Sätt genomsökningen till var 7:e dag eller av. Filer du lägger till för hand hittas då bara när du klickar på Run now på Rescan the Library.
• En torrent som seedas läser sin fil. Om den är hardlinkad in i ditt bibliotek förblir den disken vaken tills seedningen slutar.

Om det inte fungerar

Symptom	Orsak	Lösning
Startar inte, nämner en FUSE-sökväg, nätverksresurs eller Unraid-användarresurs	/config ligger inte på lokal disk (på Unraid pekar den på /mnt/user)	Flytta /config till en lokal disk eller poolsökväg, till exempel /mnt/<pool>/appdata/holyarrs.
Förblir stoppad efter en omstart eller återställning	Automatisk omstart är av	Slå på den och starta containern.
Importer misslyckas med ett behörighetsfel	PUID-användaren kan inte skriva till media	Ge den läs- och skrivrättigheter i NAS:ens behörighetsskärm (på Synology: Control Panel > Shared Folder > Edit > Permissions).
Importer blir kopior, inte hardlinks	Nedladdningar och bibliotek ligger på olika monteringar eller diskar	Montera en gemensam mapp en gång, i HolyArrs och i nedladdaren.

Fler lösningar: Felsökning.

För experter

Varför HolyArrs nekar vissa konfigurationssökvägar

HolyArrs har sina databaser i /config. Nätverksresurser och FUSE-sökvägar kan skada dem, så HolyArrs nekar att starta på en och säger varför.

På Unraid är /mnt/user en FUSE-sökväg. Använd en poolsökväg, eller gör appdata Exclusive: slå på Permit exclusive shares i Settings > Global Share Settings och sätt sedan Shares > appdata till primär lagring på en pool och sekundär lagring till none.

En /config-sökväg på en pool som inte finns hamnar i minnet och går förlorad vid omstart av datorn. HolyArrs nekar det också. Undvik även /mnt/user för media; hardlinks över den kan misslyckas.

Varför automatisk omstart spelar roll

Omstart i appen, felsäkert läge och en återställning av backup stoppar alla HolyArrs och förväntar sig att Docker startar det igen. Utan automatisk omstart förblir det stoppat. Se Delar och felsäkert läge.

Port och uppdateringar

• Mappa porten 6262 bara mot ditt hemmanätverk. Läs Säkerhetsgrunder innan du öppnar den för någon utanför.
• För att uppdatera hämtar du den nya imagen och skapar om containern. Din data ligger kvar i /config. Se Uppdateringar.

Relaterat

• Mappar
• Biblioteksmappar
• Scheman