Risoluzione dei problemi

Trova il tuo sintomo, leggi la causa, segui la soluzione. Gli esempi usano il nome di container holyarrs; usa il tuo se è diverso.

I primi 3 controlli

1. Guarda il log: docker logs -f holyarrs. I segreti sono mascherati. Premi Ctrl+C per smettere di seguirlo; il container continua a funzionare.
2. Esegui il doctor: docker exec holyarrs /holyarrs doctor. Ogni riga dice OK, WARN o FAIL, e ogni WARN o FAIL spiega come risolvere.
3. Il problema resta? Scarica un pacchetto di supporto e chiedi aiuto. Vedi Ottenere assistenza.

Non riesco a raggiungere la pagina web

Sintomo: il browser non riesce a connettersi a http://your-server:6262.

Causa: il container è fermo, la porta non è mappata oppure c’è un proxy di mezzo.

Soluzione:

1. Esegui docker ps. Dovresti vedere holyarrs con 0.0.0.0:6262->6262.
2. Se continua a riavviarsi, leggi docker logs holyarrs per capire perché.
3. Se usi un percorso come /holyarrs, vedi Reverse proxy e URL base.

Permesso negato

Sintomo: il doctor dice che una cartella non è scrivibile, oppure le importazioni falliscono con un errore di permesso.

Causa: il proprietario della cartella sull’host non corrisponde a PUID e PGID.

Soluzione: esegui il chown che suggerisce il doctor, oppure imposta PUID e PGID sul proprietario della cartella. Su un NAS, dai a quell’utente lettura e scrittura nella schermata dei permessi. Vedi NAS, Synology e Unraid.

Non scarica niente

Sintomo: i titoli restano mancanti e non arriva niente al tuo downloader.

Causa: nessuna fonte risponde, il downloader non è connesso oppure nessuna release passa le tue regole di scelta.

Soluzione:

1. Apri Settings > Downloaders (Impostazioni > Downloader) e fai clic su Test (Prova) sul tuo downloader. Deve passare.
2. Apri Settings > Sources (Impostazioni > Fonti) e fai clic su Test su ogni fonte.
3. Sul titolo, apri Choose a release (Scegliere una release) per vedere ogni risultato e i motivi per cui non è stato scelto.

Vedi Downloader e Fonti.

Scaricato ma non importato

Sintomo: il download è finito nel tuo downloader, ma il titolo non è nella tua Libreria.

Causa: HolyArrs non vede il file allo stesso percorso, non può scrivere nella cartella della Libreria, oppure l’importazione richiede una decisione.

Soluzione:

1. Dai a HolyArrs e al downloader la stessa cartella di download allo stesso percorso, come /downloads, oppure imposta Downloader’s path (percorso del downloader) e HolyArrs’ path (percorso di HolyArrs) sul downloader.
2. Esegui il doctor e correggi ogni FAIL sulle cartelle di download o della Libreria.
3. Controlla nell’elenco dei download gli elementi segnati Needs a decision (Richiede una decisione), e approva o scarta il piano.

Le importazioni sono copie, non hardlink

Sintomo: il doctor dice che gli hardlink (collegamenti fisici) non funzionano, oppure l’uso del disco raddoppia dopo le importazioni.

Causa: le cartelle dei download e della Libreria sono su dischi o mount diversi.

Soluzione: monta nel container una sola cartella padre condivisa invece di cartelle separate. Vedi Cartelle.

HolyArrs non si avvia

Sintomo: il container si ferma o si riavvia subito.

Causa: la indica il log. Le più comuni: /config su una condivisione di rete o su un percorso FUSE, oppure una parte guasta.

Soluzione:

1. Sposta /config su un disco locale se lo dice il log. HolyArrs non esegue il suo database su una condivisione.
2. Altrimenti avvia in modalità sicura, correggi da Settings (Impostazioni) e riavvia normalmente.

Manca una funzione

Sintomo: una funzione di cui hai letto non c’è nell’app.

Causa: potrebbe essere in sospeso in questa versione.

Soluzione: vedi Funzioni in sospeso.

Le pagine non hanno nomi né immagini

Sintomo: i titoli compaiono senza locandine né dettagli.

Causa: il server dei metadati non è raggiungibile.

Soluzione: controlla il tuo DNS e il firewall. La sezione Network del doctor mostra se il server risponde.

Per esperti

Controlli e opzioni del doctor

Il doctor gira dentro il container con lo stesso utente con cui gira HolyArrs, quindi incontra ciò che incontra HolyArrs.

Sezione	Mostra
App	Versione, utente e gruppo, umask, se gira in un container.
Config folder	Proprietario, permessi, spazio libero, se è su un disco locale.
Library and download folders	Esiste, proprietario, scrivibile, spazio libero, hardlink tra le cartelle dei download e della Libreria.
Network	Se il nome del server dei metadati si risolve e se risponde.
Clock	Ora, fuso orario (TZ), un’avvertenza quando l’orologio è chiaramente sbagliato.

Opzione	Cosa fa
-config <folder>	Controlla una cartella di configurazione di HolyArrs diversa da /config.
-json	Stampa il rapporto in JSON.

Il codice di uscita 0 significa che non è fallito niente; 1 significa che una riga dice FAIL. Il rapporto non mostra mai chiavi, password o token. Si limita a leggere, tranne per un piccolo file di prova che scrive e rimuove. Se avviato come root, assegna anche la cartella di configurazione a PUID:PGID, come in un avvio normale.

Se HolyArrs continua a riavviarsi, docker exec fallisce. Esegui il doctor in un nuovo container con le stesse cartelle:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Con Compose: docker compose run --rm holyarrs doctor.

Controllo delle cartelle all'avvio

All’avvio, HolyArrs controlla le sue cartelle e registra una riga di riepilogo, come folders: 4 ok, 1 not writable, poi una riga per ogni cartella con problemi, con una soluzione. Il controllo si ferma dopo 3 secondi, così l’avvio non si blocca mai. Una cartella troppo lenta a rispondere conta come non controllata; spesso è un disco che si sveglia dalla sospensione oppure una condivisione di rete lenta. Il doctor la controlla senza limite di tempo. Vedi Log.

Nessuna shell nell'immagine

L’immagine contiene solo il programma HolyArrs, così resta piccola e lascia meno spazio a un attaccante. docker exec holyarrs sh fallisce di proposito. Per guardare più da vicino, avvia un assistente temporaneo accanto:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Vede il processo di HolyArrs, condivide la sua rete e ha le stesse cartelle agli stessi percorsi. Gira come root, quindi guarda ma non modificare: un file scritto come root potrebbe non essere leggibile per HolyArrs. Per provare come utente di HolyArrs, aggiungi --user <PUID>:<PGID>.

Trovare la versione

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

La sezione App del doctor mostra lo stesso.

Correlati

• Ottenere assistenza
• Log
• Controlli di salute