NAS, Synology e Unraid

Esegui HolyArrs sul tuo NAS con le cartelle, il proprietario e l’impostazione di riavvio giusti. Leggi prima Installazione.

Prima di iniziare

• /config va su un volume o un pool locale. Mai su una condivisione di rete.
• I file multimediali vanno in un’unica cartella condivisa con dentro downloads, movies, tv e music. Monta ciascuna, oppure la cartella superiore una volta sola per gli hardlink (collegamento fisico). Vedi Cartelle.

Configurare il tuo NAS

::tab[Synology]

1. In File Station, crea docker/holyarrs/config.
2. Crea una cartella condivisa media con dentro downloads, movies, tv e music.
3. In Container Manager, apri Project > Create (progetto > crea) e incolla il file Compose da Installazione.
4. Imposta i volumi su /volume1/docker/holyarrs/config:/config, poi /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music e /volume1/media/downloads:/downloads.
5. Imposta PUID e PGID sul tuo utente, spesso 1026 e 100. Controlla con id <user> via SSH.
6. Dai a quell’utente lettura e scrittura su media: Control Panel > Shared Folder > Edit > Permissions (pannello di controllo > cartella condivisa > modifica > permessi).
7. Spunta Enable auto-restart (abilita il riavvio automatico).
8. Apri http://your-server:6262. Dovresti vedere la procedura guidata del primo avvio. Aggiungi /movies, /tv e /music come cartelle della Libreria.

::tab[Unraid]

Non c’è ancora un modello per Community Applications, quindi aggiungi il container a mano.

1. Nella scheda Docker, aggiungi un container con l’immagine di HolyArrs.
2. Mappa la porta 6262.
3. Mappa /config a un percorso di un pool, come /mnt/<pool>/appdata/holyarrs. <pool> è il nome del tuo pool. Non /mnt/user/appdata.
4. Mappa le tue cartelle multimediali a /movies, /tv, /music e /downloads, usando percorsi di dischi o pool, per esempio /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music e /mnt/<pool>/media/downloads:/downloads.
5. Imposta PUID=99, PGID=100 (il nobody:users di Unraid) e UMASK=022.
6. Attiva l’avvio automatico per il container, così si riavvia da solo.
7. Apri http://your-server:6262. Dovresti vedere la procedura guidata del primo avvio.

::tab[QNAP]

1. Crea Container/holyarrs/config e una condivisione media con dentro downloads, movies, tv e music.
2. In Container Station, apri Applications > Create (applicazioni > crea) e incolla il file Compose.
3. Usa /share/Container/holyarrs/config:/config, poi /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music e /share/media/downloads:/downloads.
4. Imposta PUID e PGID sul proprietario della condivisione media.
5. Imposta il criterio di riavvio su unless-stopped.
6. Apri http://your-server:6262. Dovresti vedere la procedura guidata del primo avvio.

::tab[TrueNAS SCALE]

1. Crea 2 dataset: apps/holyarrs-config e media, con le cartelle downloads, movies, tv e music dentro media.
2. In Apps, aggiungi un’app personalizzata da YAML con il file Compose.
3. Usa /mnt/<pool>/apps/holyarrs-config:/config, poi /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music e /mnt/<pool>/media/downloads:/downloads.
4. Imposta PUID e PGID sul proprietario del dataset, spesso 568. Dai a quell’utente l’accesso in scrittura nell’ACL del dataset.
5. Imposta il criterio di riavvio su unless-stopped.
6. Apri http://your-server:6262. Dovresti vedere la procedura guidata del primo avvio.

Su ogni NAS: dai all’utente PUID lettura e scrittura sulla cartella multimediale nella schermata dei permessi del NAS; della cartella di configurazione si occupa HolyArrs. Attiva il riavvio automatico per il container (il criterio unless-stopped di Docker).

Per gli hardlink, che non occupano spazio in più e finiscono subito, monta l’unica cartella multimediale al posto delle quattro, e dai al tuo downloader lo stesso mount nello stesso percorso. Vedi Cartelle multimediali.

Scelte

Mount separati

Montare /movies, /tv, /music e /downloads uno per uno funziona, ma ogni importazione diventa una copia completa. Ogni mount è un filesystem a sé dentro il container, e un hardlink non può attraversare i filesystem. Anche condivisioni o dataset separati sotto una stessa cartella superiore fanno copie. Settings > Library folders (Impostazioni > Cartelle della Libreria) ti avverte quando HolyArrs deve copiare.

Lasciare dormire i dischi

Questi processi svegliano i dischi dei file multimediali. Cambia ogni quanto girano nella pagina Schedules (pianificazioni).

Processo	Cosa legge
Rescan the Library (riscansiona la Libreria)	Ogni cartella della Libreria. Sveglia di più i dischi.
Check Library folders (controlla le cartelle della Libreria)	I dettagli e lo spazio libero di ogni cartella. Il test di scrittura e hardlink gira solo all’avvio, su Run now (esegui ora) e quando le cartelle cambiano.
Look for missing subtitles (cerca i sottotitoli mancanti), Look for better subtitles (cerca sottotitoli migliori)	La cartella accanto a ogni video.

• Metti /config e la cartella dei download su un SSD o su un pool di cache.
• Tieni 1 GB liberi sul disco che contiene /config. Sotto quella soglia ricevi un’avvertenza di salute.
• Su Unraid, il plugin Cache Directories tiene gli elenchi delle cartelle in memoria, così le scansioni non toccano il disco.
• Importazioni, aggiunte ed eliminazioni toccano il disco su cui lavorano, quando avvengono.
• Imposta la riscansione ogni 7 giorni o disattivala. I file che aggiungi a mano vengono allora trovati solo quando premi Run now su Rescan the Library.
• Un torrent in seeding legge il suo file. Se è collegato con un hardlink alla tua Libreria, quel disco resta sveglio finché il seeding non finisce.

Se non funziona

Sintomo	Causa	Soluzione
Non si avvia, nomina un percorso FUSE, una condivisione di rete o una user share di Unraid	/config non è su un disco locale (su Unraid, punta a /mnt/user)	Sposta /config su un percorso di disco o pool locale, come /mnt/<pool>/appdata/holyarrs.
Resta fermo dopo un riavvio o un ripristino	Il riavvio automatico è disattivato	Attivalo e avvia il container.
Le importazioni falliscono con un errore di permessi	L’utente PUID non può scrivere sui file multimediali	Dagli lettura e scrittura nella schermata dei permessi del NAS (su Synology: Control Panel > Shared Folder > Edit > Permissions).
Le importazioni sono copie, non hardlink	Download e Libreria stanno su mount o dischi diversi	Monta una sola cartella condivisa, una volta, in HolyArrs e nel downloader.

Altre soluzioni: Risoluzione dei problemi.

Per esperti

Perché HolyArrs rifiuta alcuni percorsi di configurazione

HolyArrs tiene i suoi database in /config. Condivisioni di rete e percorsi FUSE possono corromperli, quindi HolyArrs si rifiuta di avviarsi su uno di essi e dice perché.

Su Unraid, /mnt/user è un percorso FUSE. Usa un percorso di un pool, oppure rendi appdata Exclusive: attiva Permit exclusive shares in Settings > Global Share Settings, poi imposta Shares > appdata con archiviazione primaria su un solo pool e archiviazione secondaria su nessuna.

Un percorso /config su un pool che non esiste finisce in memoria e si perde al riavvio. HolyArrs rifiuta anche questo. Evita /mnt/user anche per i file multimediali; gli hardlink che lo attraversano possono fallire.

Perché il riavvio automatico conta

Il riavvio dall’app, la modalità sicura e il ripristino di un backup arrestano tutti HolyArrs e si aspettano che Docker lo avvii di nuovo. Senza riavvio automatico resta fermo. Vedi Parti e modalità sicura.

Porta e aggiornamenti

• Mappa la porta 6262 solo sulla tua rete di casa. Leggi le Nozioni di base sulla sicurezza prima di aprirla a chiunque sia fuori.
• Per aggiornare, scarica la nuova immagine e ricrea il container. I tuoi dati restano in /config. Vedi Aggiornamenti.

Correlati

• Cartelle
• Cartelle della Libreria
• Pianificazioni