NAS, Synology și Unraid

Rulează HolyArrs pe NAS-ul tău cu dosarele, proprietarul și setarea de repornire potrivite. Citește mai întâi Instalare.

Înainte să începi

• /config merge pe un volum sau pe un pool local. Niciodată pe un dosar partajat în rețea.
• Media merge într-un singur dosar partajat, cu downloads, movies, tv și music înăuntru. Montează fiecare dosar, sau montează o dată dosarul părinte pentru hardlink-uri (legături fizice). Vezi Dosare.

Configurează-ți NAS-ul

::tab[Synology]

1. În File Station, creează docker/holyarrs/config.
2. Creează un singur dosar partajat media, cu downloads, movies, tv și music înăuntru.
3. În Container Manager, deschide Project > Create (Proiect > Creare) și lipește fișierul Compose din Instalare.
4. Setează volumele la /volume1/docker/holyarrs/config:/config, apoi /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music și /volume1/media/downloads:/downloads.
5. Setează PUID și PGID la utilizatorul tău, adesea 1026 și 100. Verifică cu id <user> prin SSH.
6. Dă acelui utilizator drept de citire și scriere pe media: Control Panel > Shared Folder > Edit > Permissions (Panou de control > Dosar partajat > Editare > Permisiuni).
7. Bifează Enable auto-restart (activează repornirea automată).
8. Deschide http://your-server:6262. Ar trebui să vezi expertul de la prima pornire. Adaugă /movies, /tv și /music ca dosare ale Bibliotecii.

::tab[Unraid]

Nu există încă un șablon în Community Applications, așa că adaugă containerul de mână.

1. În fila Docker, adaugă un container cu imaginea HolyArrs.
2. Mapează portul 6262.
3. Mapează /config la o cale de pool, cum ar fi /mnt/<pool>/appdata/holyarrs. <pool> este numele pool-ului tău. Nu /mnt/user/appdata.
4. Mapează dosarele tale media la /movies, /tv, /music și /downloads, folosind căi de disc sau de pool, de exemplu /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music și /mnt/<pool>/media/downloads:/downloads.
5. Setează PUID=99, PGID=100 (nobody:users din Unraid) și UMASK=022.
6. Pornește auto-start pentru container, ca să repornească singur.
7. Deschide http://your-server:6262. Ar trebui să vezi expertul de la prima pornire.

::tab[QNAP]

1. Creează Container/holyarrs/config și un singur dosar partajat media, cu downloads, movies, tv și music înăuntru.
2. În Container Station, deschide Applications > Create (Aplicații > Creare) și lipește fișierul Compose.
3. Folosește /share/Container/holyarrs/config:/config, apoi /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music și /share/media/downloads:/downloads.
4. Setează PUID și PGID la proprietarul dosarului partajat media.
5. Setează politica de repornire la unless-stopped.
6. Deschide http://your-server:6262. Ar trebui să vezi expertul de la prima pornire.

::tab[TrueNAS SCALE]

1. Creează 2 dataset-uri: apps/holyarrs-config și media, cu dosarele downloads, movies, tv și music în media.
2. În Apps, adaugă o aplicație personalizată din YAML cu fișierul Compose.
3. Folosește /mnt/<pool>/apps/holyarrs-config:/config, apoi /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music și /mnt/<pool>/media/downloads:/downloads.
4. Setează PUID și PGID la proprietarul dataset-ului, adesea 568. Dă acelui utilizator permisiune de scriere în ACL-ul dataset-ului.
5. Setează politica de repornire la unless-stopped.
6. Deschide http://your-server:6262. Ar trebui să vezi expertul de la prima pornire.

Pe orice NAS: dă utilizatorului PUID drept de citire și scriere pe dosarul media în ecranul de permisiuni al NAS-ului; HolyArrs se ocupă singur de dosarul de configurare. Pornește repornirea automată pentru container (politica Docker unless-stopped).

Pentru hardlink-uri, care nu iau spațiu în plus și se termină pe loc, montează dosarul media unic în locul celor patru și dă programului tău de descărcare aceeași montare, la aceeași cale. Vezi Dosare media.

Alegeri

Montări separate

Montarea separată a /movies, /tv, /music și /downloads funcționează, dar fiecare import devine o copie completă. Fiecare montare e propriul ei sistem de fișiere în container, iar un hardlink nu poate trece dintr-un sistem de fișiere în altul. Dosarele partajate sau dataset-urile separate sub un singur părinte se copiază și ele. Settings > Library folders (Setări > Dosarele Bibliotecii) te avertizează când HolyArrs trebuie să copieze.

Lasă-ți discurile să doarmă

Aceste sarcini trezesc discurile media. Schimbă cât de des rulează în pagina Schedules (Programe).

Sarcină	Ce citește
Rescan the Library (rescanează Biblioteca)	Fiecare dosar al Bibliotecii. Trezește discurile cel mai mult.
Check Library folders (verifică dosarele Bibliotecii)	Detaliile și spațiul liber ale fiecărui dosar. Testul de scriere și de hardlink rulează doar la pornire, la Run now (rulează acum) și când se schimbă dosarele.
Look for missing subtitles, Look for better subtitles (caută subtitrări care lipsesc, caută subtitrări mai bune)	Dosarul de lângă fiecare videoclip.

• Pune /config și dosarul de descărcări pe un SSD sau pe un pool de cache.
• Păstrează 1 GB liber pe discul care ține /config. Sub asta primești un avertisment de sănătate.
• Pe Unraid, pluginul Cache Directories ține listele de dosare în memorie, așa că scanările nu ating discul.
• Importurile, adăugările și ștergerile ating discul pe care lucrează, atunci când se întâmplă.
• Setează rescanarea la 7 zile sau oprește-o. Fișierele adăugate de mână sunt atunci găsite doar când apeși Run now la Rescan the Library.
• Un torrent care face seeding își citește fișierul. Dacă e legat prin hardlink în Biblioteca ta, discul acela rămâne treaz până se oprește seeding-ul.

Dacă nu merge

Simptom	Cauză	Soluție
Nu pornește, numește o cale FUSE, un dosar partajat în rețea sau un user share Unraid	/config nu e pe un disc local (pe Unraid, arată spre /mnt/user)	Mută /config pe un disc local sau pe o cale de pool, cum ar fi /mnt/<pool>/appdata/holyarrs.
Rămâne oprit după o repornire sau o restaurare	Repornirea automată e oprită	Pornește-o, apoi pornește containerul.
Importurile eșuează cu o eroare de permisiune	Utilizatorul PUID nu poate scrie în media	Dă-i drept de citire și scriere în ecranul de permisiuni al NAS-ului (pe Synology: Control Panel > Shared Folder > Edit > Permissions).
Importurile sunt copii, nu hardlink-uri	Descărcările și Biblioteca sunt pe montări sau discuri diferite	Montează o singură dată un dosar partajat, în HolyArrs și în programul de descărcare.

Mai multe soluții: Depanare.

Pentru experți

De ce refuză HolyArrs unele căi de configurare

HolyArrs își ține bazele de date în /config. Dosarele partajate în rețea și căile FUSE pot corupe bazele de date, așa că HolyArrs refuză să pornească pe una și spune de ce.

Pe Unraid, /mnt/user e o cale FUSE. Folosește o cale de pool, sau fă appdata Exclusive: pornește Permit exclusive shares în Settings > Global Share Settings, apoi setează Shares > appdata la stocare primară pe un singur pool și la stocare secundară pe none.

O cale /config pe un pool care nu există ajunge în memorie și se pierde la repornire. HolyArrs refuză și asta. Evită /mnt/user și pentru media; hardlink-urile prin el pot eșua.

De ce contează repornirea automată

Repornirea din aplicație, modul sigur și restaurarea unei copii de rezervă opresc toate HolyArrs și se așteaptă ca Docker să-l pornească din nou. Fără repornire automată rămâne oprit. Vezi Părți și mod sigur.

Port și actualizări

• Mapează portul 6262 doar la rețeaua ta de acasă. Citește Bazele securității înainte să-l deschizi cuiva din afară.
• Ca să actualizezi, trage imaginea nouă și recreează containerul. Datele tale rămân în /config. Vezi Actualizări.

Vezi și

• Dosare
• Dosarele Bibliotecii
• Programe