NAS, Synology i Unraid

Fes funcionar HolyArrs al teu NAS amb les carpetes, el propietari i el paràmetre de reinici correctes. Llegeix primer Instal·lació.

Abans de començar

• /config va en un volum o pool local. Mai en una carpeta compartida de xarxa.
• Els mitjans van en una sola carpeta compartida amb downloads, movies, tv i music a dins. Munta cadascuna, o la carpeta pare una sola vegada per als hardlinks (enllaços durs). Consulta Carpetes.

Configura el teu NAS

::tab[Synology]

1. A File Station, crea docker/holyarrs/config.
2. Crea una sola carpeta compartida media amb downloads, movies, tv i music a dins.
3. A Container Manager, obre Project > Create (Projecte > Crear) i enganxa el fitxer Compose de Instal·lació.
4. Posa els volums a /volume1/docker/holyarrs/config:/config, després /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music i /volume1/media/downloads:/downloads.
5. Posa PUID i PGID al teu usuari, sovint 1026 i 100. Comprova-ho amb id <user> per SSH.
6. Dona a aquest usuari lectura i escriptura a media: Control Panel > Shared Folder > Edit > Permissions (Tauler de control > Carpeta compartida > Editar > Permisos).
7. Marca Enable auto-restart (activar el reinici automàtic).
8. Obre http://your-server:6262. Hauries de veure l’assistent del primer inici. Afegeix /movies, /tv i /music com a carpetes de la Biblioteca.

::tab[Unraid]

Encara no hi ha cap plantilla de Community Applications, així que afegeix el contenidor a mà.

1. A la pestanya Docker, afegeix un contenidor amb la imatge d’HolyArrs.
2. Mapa el port 6262.
3. Mapa /config a una ruta d’un pool, com /mnt/<pool>/appdata/holyarrs. <pool> és el nom del teu pool. No /mnt/user/appdata.
4. Mapa les teves carpetes de mitjans a /movies, /tv, /music i /downloads, amb rutes de disc o de pool, per exemple /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music i /mnt/<pool>/media/downloads:/downloads.
5. Posa PUID=99, PGID=100 (el nobody:users d’Unraid) i UMASK=022.
6. Activa l’inici automàtic del contenidor, perquè es reiniciï sol.
7. Obre http://your-server:6262. Hauries de veure l’assistent del primer inici.

::tab[QNAP]

1. Crea Container/holyarrs/config i una sola carpeta compartida media amb downloads, movies, tv i music a dins.
2. A Container Station, obre Applications > Create (Aplicacions > Crear) i enganxa el fitxer Compose.
3. Fes servir /share/Container/holyarrs/config:/config, després /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music i /share/media/downloads:/downloads.
4. Posa PUID i PGID al propietari de la carpeta compartida media.
5. Posa la política de reinici a unless-stopped.
6. Obre http://your-server:6262. Hauries de veure l’assistent del primer inici.

::tab[TrueNAS SCALE]

1. Crea 2 datasets: apps/holyarrs-config i media, amb les carpetes downloads, movies, tv i music dins de media.
2. A Apps, afegeix una app personalitzada des de YAML amb el fitxer Compose.
3. Fes servir /mnt/<pool>/apps/holyarrs-config:/config, després /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music i /mnt/<pool>/media/downloads:/downloads.
4. Posa PUID i PGID al propietari del dataset, sovint 568. Dona a aquest usuari accés d’escriptura a l’ACL del dataset.
5. Posa la política de reinici a unless-stopped.
6. Obre http://your-server:6262. Hauries de veure l’assistent del primer inici.

A tots els NAS: dona a l’usuari del PUID lectura i escriptura a la carpeta de mitjans a la pantalla de permisos del NAS; HolyArrs s’ocupa ell mateix de la carpeta de configuració. Activa el reinici automàtic del contenidor (la política unless-stopped de Docker).

Per als hardlinks, que no ocupen espai extra i acaben a l’instant, munta la carpeta de mitjans única en lloc de les quatre, i dona al teu gestor de baixades el mateix muntatge a la mateixa ruta. Consulta Carpetes de mitjans.

Opcions

Muntatges separats

Muntar /movies, /tv, /music i /downloads un per un funciona, però cada importació passa a ser una còpia completa. Cada muntatge és un sistema de fitxers propi dins del contenidor, i un hardlink no pot creuar sistemes de fitxers. Les carpetes compartides o datasets separats sota un mateix pare també es copien. Settings > Library folders (Paràmetres > Carpetes de la Biblioteca) t’avisa quan HolyArrs ha de copiar.

Deixa que els teus discos dormin

Aquestes tasques desperten els discos dels mitjans. Canvia cada quant s’executen a la pàgina Schedules (programacions).

Tasca	Què llegeix
Rescan the Library (tornar a explorar la Biblioteca)	Totes les carpetes de la Biblioteca. És la que més desperta els discos.
Check Library folders (comprovar les carpetes de la Biblioteca)	Els detalls i l’espai lliure de cada carpeta. La prova d’escriptura i de hardlink només s’executa a l’inici, amb Run now (executar ara) i quan les carpetes canvien.
Look for missing subtitles, Look for better subtitles (cercar subtítols que falten, cercar subtítols millors)	La carpeta al costat de cada vídeo.

• Posa /config i la carpeta de baixades en un SSD o pool de cau.
• Deixa 1 GB lliure al disc que conté /config. Per sota d’això reps una advertència de salut.
• A Unraid, el plugin Cache Directories manté els llistats de carpetes a la memòria, així que les exploracions s’estalvien el disc.
• Les importacions, les addicions i les eliminacions toquen el disc on treballen, quan passen.
• Posa l’exploració cada 7 dies o desactivada. Els fitxers que afegeixes a mà només es troben quan cliques a Run now a Rescan the Library.
• Un torrent que fa seeding llegeix el seu fitxer. Si està enllaçat amb un hardlink a la teva Biblioteca, aquest disc es manté despert fins que acabi el seeding.

Si no funciona

Símptoma	Causa	Solució
No s’inicia, anomena una ruta FUSE, una carpeta compartida de xarxa o una carpeta compartida d’usuari d’Unraid	/config no és en un disc local (a Unraid, apunta a /mnt/user)	Mou /config a una ruta de disc local o de pool, com /mnt/<pool>/appdata/holyarrs.
Es queda aturat després d’un reinici o una restauració	El reinici automàtic està desactivat	Activa’l i inicia el contenidor.
Les importacions fallen amb un error de permisos	L’usuari del PUID no pot escriure als mitjans	Dona-li lectura i escriptura a la pantalla de permisos del NAS (a Synology: Control Panel > Shared Folder > Edit > Permissions).
Les importacions són còpies, no hardlinks	Les baixades i la Biblioteca són en muntatges o discos diferents	Munta una sola carpeta compartida una vegada, a HolyArrs i al gestor de baixades.

Més solucions: Resolució de problemes.

Per a experts

Per què HolyArrs rebutja algunes rutes de configuració

HolyArrs desa les seves bases de dades a /config. Les carpetes compartides de xarxa i les rutes FUSE les poden corrompre, així que HolyArrs es nega a iniciar-se en una i diu per què.

A Unraid, /mnt/user és una ruta FUSE. Fes servir una ruta de pool, o fes appdata Exclusive: activa Permit exclusive shares (permetre carpetes compartides exclusives) a Settings > Global Share Settings (Paràmetres > Paràmetres globals de carpetes compartides), i després posa Shares > appdata (Carpetes compartides > appdata) a emmagatzematge primari en un pool i l’emmagatzematge secundari a cap.

Una ruta /config en un pool que no existeix acaba a la memòria i es perd en reiniciar. HolyArrs també ho rebutja. Evita també /mnt/user per als mitjans; els hardlinks que el creuen poden fallar.

Per què importa el reinici automàtic

Reiniciar des de l’app, el mode segur i una restauració de còpia de seguretat aturen HolyArrs i esperen que Docker l’iniciï de nou. Sense reinici automàtic es queda aturat. Consulta Parts i mode segur.

Port i actualitzacions

• Mapa el port 6262 només a la teva xarxa de casa. Llegeix Bàsics de seguretat abans d’obrir-lo a algú de fora.
• Per actualitzar, baixa la imatge nova i torna a crear el contenidor. Les teves dades es queden a /config. Consulta Actualitzacions.

Relacionat

• Carpetes
• Carpetes de la Biblioteca
• Programacions