NAS, Synology en Unraid

Draai HolyArrs op je NAS met de juiste mappen, eigenaar en herstartinstelling. Lees eerst Installeren.

Voor je begint

• /config komt op een lokaal volume of lokale pool. Nooit op een netwerkshare.
• Media komt in één gedeelde map met daarin downloads, movies, tv en music. Mount ze apart, of mount de bovenliggende map één keer voor hardlinks (harde koppelingen). Zie Mappen.

Je NAS instellen

::tab[Synology]

1. Maak in File Station docker/holyarrs/config.
2. Maak één gedeelde map media met daarin downloads, movies, tv en music.
3. Open in Container Manager Project > Create (Project > Aanmaken) en plak het Compose-bestand van Installeren.
4. Stel de volumes in op /volume1/docker/holyarrs/config:/config, dan /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music en /volume1/media/downloads:/downloads.
5. Stel PUID en PGID in op jouw gebruiker, vaak 1026 en 100. Controleer dit met id <user> via SSH.
6. Geef die gebruiker lees- en schrijfrechten op media: Control Panel > Shared Folder > Edit > Permissions (Configuratiescherm > Gedeelde map > Bewerken > Rechten).
7. Vink Enable auto-restart (automatisch herstarten inschakelen) aan.
8. Open http://your-server:6262. Je ziet nu de wizard voor de eerste start. Voeg /movies, /tv en /music toe als bibliotheekmappen.

::tab[Unraid]

Er is nog geen template in Community Applications, dus voeg de container met de hand toe.

1. Voeg op het tabblad Docker een container toe met de HolyArrs-image.
2. Wijs poort 6262 toe.
3. Wijs /config toe aan een pad op een pool, zoals /mnt/<pool>/appdata/holyarrs. <pool> is de naam van je pool. Niet /mnt/user/appdata.
4. Wijs je mediamappen toe aan /movies, /tv, /music en /downloads, met paden van een schijf of pool, bijvoorbeeld /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music en /mnt/<pool>/media/downloads:/downloads.
5. Stel PUID=99, PGID=100 (nobody:users van Unraid) en UMASK=022 in.
6. Zet automatisch starten voor de container aan, zodat hij vanzelf herstart.
7. Open http://your-server:6262. Je ziet nu de wizard voor de eerste start.

::tab[QNAP]

1. Maak Container/holyarrs/config en één media-share met daarin downloads, movies, tv en music.
2. Open in Container Station Applications > Create (Applicaties > Aanmaken) en plak het Compose-bestand.
3. Gebruik /share/Container/holyarrs/config:/config, dan /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music en /share/media/downloads:/downloads.
4. Stel PUID en PGID in op de eigenaar van de media-share.
5. Stel het herstartbeleid in op unless-stopped.
6. Open http://your-server:6262. Je ziet nu de wizard voor de eerste start.

::tab[TrueNAS SCALE]

1. Maak 2 datasets: apps/holyarrs-config en media, met de mappen downloads, movies, tv en music in media.
2. Voeg in Apps een eigen app toe vanuit YAML met het Compose-bestand.
3. Gebruik /mnt/<pool>/apps/holyarrs-config:/config, dan /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music en /mnt/<pool>/media/downloads:/downloads.
4. Stel PUID en PGID in op de eigenaar van de dataset, vaak 568. Geef die gebruiker schrijftoegang in de ACL van de dataset.
5. Stel het herstartbeleid in op unless-stopped.
6. Open http://your-server:6262. Je ziet nu de wizard voor de eerste start.

Op elke NAS: geef de PUID-gebruiker lees- en schrijfrechten op de mediamap in het rechtenscherm van de NAS; de configuratiemap regelt HolyArrs zelf. Zet automatisch herstarten aan voor de container (het beleid unless-stopped van Docker).

Voor hardlinks, die geen extra ruimte kosten en direct klaar zijn, mount je de ene mediamap in plaats van de vier, en geef je je downloader dezelfde mount op hetzelfde pad. Zie Mediamappen.

Keuzes

Aparte mounts

/movies, /tv, /music en /downloads één voor één mounten werkt, maar dan wordt elke import een volledige kopie. Elke mount is binnen de container een eigen bestandssysteem, en een hardlink kan niet over bestandssystemen heen. Aparte shares of datasets onder één bovenliggende map kopiëren ook. Settings > Library folders (Instellingen > Bibliotheekmappen) waarschuwt als HolyArrs moet kopiëren.

Laat je schijven slapen

Deze taken maken de mediaschijven wakker. Wijzig hoe vaak ze draaien op de pagina Schedules (schema’s).

Taak	Wat het leest
Rescan the Library (bibliotheek opnieuw scannen)	Elke bibliotheekmap. Maakt schijven het meest wakker.
Check Library folders (bibliotheekmappen controleren)	De gegevens en vrije ruimte van elke map. De schrijf- en hardlinktest draait alleen bij het starten, bij Run now (nu uitvoeren) en als mappen wijzigen.
Look for missing subtitles, Look for better subtitles (naar ontbrekende ondertitels zoeken, naar betere ondertitels zoeken)	De map naast elke video.

• Zet /config en de downloadmap op een SSD of cachepool.
• Houd 1 GB vrij op de schijf met /config. Daaronder krijg je een gezondheidswaarschuwing.
• Op Unraid houdt de plugin Cache Directories maplijsten in het geheugen, zodat scans de schijf overslaan.
• Imports, toevoegen en verwijderen raken de schijf waarop ze werken, op het moment dat ze gebeuren.
• Zet het opnieuw scannen op elke 7 dagen of uit. Bestanden die je met de hand toevoegt, worden dan alleen gevonden als je op Run now klikt bij Rescan the Library.
• Een torrent die seedt, leest zijn bestand. Is die als hardlink in je bibliotheek gekoppeld, dan blijft die schijf wakker tot het seeden stopt.

Als het niet werkt

Symptoom	Oorzaak	Oplossing
Start niet, noemt een FUSE-pad, netwerkshare of gebruikersshare van Unraid	/config staat niet op een lokale schijf (op Unraid wijst het naar /mnt/user)	Verplaats /config naar een pad op een lokale schijf of pool, zoals /mnt/<pool>/appdata/holyarrs.
Blijft gestopt na een herstart of terugzetten	Automatisch herstarten staat uit	Zet het aan en start de container.
Imports mislukken met een rechtenfout	De PUID-gebruiker kan niet naar media schrijven	Geef lees- en schrijfrechten in het rechtenscherm van de NAS (op Synology: Control Panel > Shared Folder > Edit > Permissions).
Imports zijn kopieën, geen hardlinks	Downloads en bibliotheek staan op verschillende mounts of schijven	Mount één gedeelde map één keer, in HolyArrs en in de downloader.

Meer oplossingen: Problemen oplossen.

Voor gevorderden

Waarom HolyArrs sommige configuratiepaden weigert

HolyArrs bewaart zijn databases in /config. Netwerkshares en FUSE-paden kunnen ze beschadigen, dus HolyArrs weigert daarop te starten en zegt waarom.

Op Unraid is /mnt/user een FUSE-pad. Gebruik een pad op een pool, of maak appdata exclusief: zet Permit exclusive shares (exclusieve shares toestaan) aan in Settings > Global Share Settings, en stel dan Shares > appdata in op primaire opslag op één pool en secundaire opslag op geen.

Een /config-pad op een pool die niet bestaat, komt in het geheugen terecht en is na een herstart weg. HolyArrs weigert dat ook. Vermijd /mnt/user ook voor media; hardlinks daarover kunnen mislukken.

Waarom automatisch herstarten belangrijk is

Herstarten in de app, veilige modus en het terugzetten van een backup stoppen HolyArrs allemaal en rekenen erop dat Docker het opnieuw start. Zonder automatisch herstarten blijft het gestopt. Zie Onderdelen en veilige modus.

Poort en updates

• Wijs poort 6262 alleen toe aan je thuisnetwerk. Lees Basis van beveiliging voordat je hem voor iemand buiten opent.
• Om te updaten haal je de nieuwe image op en maak je de container opnieuw aan. Je gegevens blijven in /config. Zie Updates.

Gerelateerde pagina’s

• Mappen
• Bibliotheekmappen
• Schema’s