Parti e modalità sicura

Disattiva le parti che non usi, avvia in modalità sicura quando qualcosa si rompe e riavvia HolyArrs dal browser.

Attivare o disattivare una parte

HolyArrs ha 5 parti: Movies (film), TV shows (serie), Music (musica), Subtitles (sottotitoli) e Requests (richieste). Le scegli la prima volta nella procedura guidata del primo avvio.

1. Apri Settings > Parts (Impostazioni > Parti).
2. Fai clic su Turn on (attiva) o Turn off (disattiva) accanto a una parte. Dovresti vedere le sue voci di menu comparire o sparire.

Non viene eliminato nulla. Riattiva una parte e riparte da dove si era fermata.

Avviare in modalità sicura

La modalità sicura avvia solo l’essenziale, per quando qualcosa impedisce a HolyArrs di avviarsi o di funzionare. Puoi accedere, guardare la tua Libreria, cambiare le impostazioni e fare o ripristinare un backup. Ricerca, aggiunta, aggiornamento, download e importazione aspettano il prossimo avvio normale.

1. Apri Settings > Danger zone (zona pericolosa).
2. Fai clic su Restart in safe mode (riavvia in modalità sicura). Dovresti vedere un banner su ogni pagina.
3. Risolvi il problema, poi fai clic su Restart HolyArrs (riavvia HolyArrs). L’avvio successivo è normale.

Se non riesci a raggiungere la pagina, imposta HOLYARRS_SAFE_MODE=1 in Compose oppure avvia con -safe-mode. Toglilo dopo la correzione: entrambi mantengono ogni avvio in modalità sicura.

Scelte

Cosa si ferma quando una parte è disattivata

Parte	Si ferma	Continua
Film	Pagine e voci di menu dei film, aggiunta, ricerca, aggiornamento	I download già nel tuo downloader vengono ancora seguiti. I file restano.
Serie	Pagine delle serie, aggiunta, ricerca, ricerche per stagione, aggiornamenti	Come per i film.
Musica	Pagine di artisti e album, impostazioni della musica, aggiornamenti degli artisti, ricerche di album	Come per i film.
Sottotitoli	Impostazioni dei sottotitoli, la pagina dei sottotitoli mancanti, ricerche e controlli	I file dei sottotitoli accanto ai tuoi video restano.
Richieste	Pagine delle richieste e richiesta di titoli	Le richieste esistenti restano e tornano quando la parte è di nuovo attiva.

Sempre attivi: accesso e account, cartelle della Libreria, Fonti, downloader e download, avvisi, Cronologia, backup, controlli di salute, impostazioni e API.

• I sottotitoli richiedono Film o Serie. Le richieste richiedono Film, Serie o Musica. HolyArrs rifiuta una modifica che rompe questa regola e dice cosa cambiare prima.
• Un processo in coda per una parte disattivata aspetta e gira quando la parte è di nuovo attiva.
• Disattivare una parte non fa risparmiare memoria. Tutto gira in un unico programma.

Riavviare, mettere in pausa e arrestare

Settings > Danger zone (proprietario e amministratori) ha Restart HolyArrs, Restart in safe mode e Shut down (arresta), più Pause (pausa), Resume (riprendi) e Restart (riavvia) per ogni attività in background, come i backup o la sincronizzazione dei download.

• I controlli che fermano qualcosa ti chiedono di confermare entro 60 s.
• Ogni controllo usato viene scritto nella Cronologia con il tuo nome.
• Serve un accesso con password. Un accesso senza password sulla tua rete locale viene rifiutato.

Il riavvio arresta HolyArrs in modo pulito e lascia che Docker lo avvii di nuovo, quindi imposta restart: unless-stopped.

Criterio di riavvio	Riavvio	Arresto
unless-stopped o always	Torna su	Torna su anche questo
on-failure	Torna su	Resta giù
no	Resta giù	Resta giù

Se non funziona

Sintomo	Causa	Soluzione
HolyArrs non riesce a disattivare una parte	Un’altra parte ne ha bisogno	Disattiva prima quell’altra parte, come dice il messaggio.
Il riavvio ha arrestato HolyArrs per sempre	Il criterio di riavvio è no	Avvia il container e imposta restart: unless-stopped.
I controlli vengono rifiutati	Accesso locale senza password, o la chiave non ha control	Accedi con la tua password.
Un’attività resta in errore	Ha bisogno di te	Leggi il motivo su /health, risolvi, fai clic su Restart per quell’attività.

Altre soluzioni: Risoluzione dei problemi.

Per esperti

Stati di salute

/health, Settings > Parts e GET /api/v1/health/states elencano ogni attività in background, parte e app collegata con uno stato e un motivo.

Stato	Significato
off	Disattivata, in pausa, o non avviata in modalità sicura.
starting	In avvio, o non ancora controllata.
running	Funziona.
retrying	Fallita; HolyArrs riprova, aspettando più a lungo ogni volta.
failed	Andata in crash, bloccata o ha bisogno di te. Il motivo dice cosa fare.

Un’attività andata in crash mostra failed, poi retrying, poi riparte. Nel frattempo accesso, Libreria e backup continuano a funzionare. Un’attività bloccata si sblocca con un riavvio completo.

Memoria e modalità a basso consumo di memoria

HolyArrs punta a restare sotto 384 MiB, che sta in un limite di 500 MB per il container. Per impostare un tuo obiettivo, imposta GOMEMLIMIT a circa l’80 percento della memoria del container.

La modalità a basso consumo di memoria tiene meno cose in memoria e legge di più dal database. Alcune pagine impiegano un attimo in più, e il lavoro in background, come la copia del catalogo musicale, gira meno spesso.

Impostazione	Effetto
(predefinito, Linux)	Si attiva da sola a circa 2.5 GiB di memoria o meno.
HOLYARRS_LOW_MEMORY=1	Sempre attiva.
HOLYARRS_LOW_MEMORY=0	Sempre disattivata.

La prima riga del log dice se è attiva e perché.

Ambiti delle chiavi API

Crea una chiave in Settings > API > API keys (chiavi API) e inviala nell’header X-Api-Key.

Ambito	Raggiunge
read	Libreria, processi, download, Cronologia, salute, impostazioni. Segreti nascosti.
health_read	Solo gli stati di salute. Per gli strumenti di monitoraggio.
write	Ogni modifica tranne le route di amministrazione e i controlli.
admin	Persone, inviti, limiti delle richieste, chiavi API, password e autenticazione a due fattori, impostazioni di accesso, backup.
control	I controlli di questa pagina. Solo il proprietario e gli amministratori possono concederlo.
all	read, write e admin. Non control.

Una chiave non fa mai più della persona che l’ha creata. Gli ambiti non si possono cambiare dopo; crea una nuova chiave. Ogni route e il suo ambito: /api/v1/openapi.json.

Correlati

• Controlli di salute
• Backup
• Route dell’API