Aggiornamenti

HolyArrs ti avvisa quando esce una nuova versione e non la installa mai da solo. Scarichi la nuova immagine quando ti fa comodo.

Vedere se è uscita una nuova versione

1. Apri la pagina Status (Stato): http://your-server:6262/health.
2. Leggi Updates (aggiornamenti). Dovresti vedere uno di questi messaggi:

Messaggio	Significato
“HolyArrs 1.2.0 is out, newer than this one.”	Aggiorna quando vuoi
“This is the newest version.”	Non c’è niente da fare
“No HolyArrs release is published yet.”	Il feed è vuoto. Non c’è nessun problema
“The last check did not work: …”	Feed non raggiunto, di solito manca internet
“The update check is off: …”	Disattivato nelle Impostazioni

3. Per controllare subito, premi Check now (controlla ora) o Check again (controlla di nuovo). Serve il permesso Change settings (modificare le impostazioni).

Una versione più recente compare anche come avvertenza di salute. Un controllo fallito compare solo sotto Updates.

Aggiornare

1. Scarica la nuova immagine e riavvia: docker compose pull, poi docker compose up -d.
2. HolyArrs si avvia. Se la nuova versione cambia il modo in cui i dati vengono salvati, prima fa un backup, poi aggiorna i dati. Dovresti vedere l’app aprirsi sulla nuova versione.

Consiglio

Un passaggio di aggiornamento fallito viene annullato e HolyArrs si ferma su una pagina che spiega cos’è successo. I tuoi dati di prima dell’aggiornamento restano come backup.

Tornare alla versione precedente

HolyArrs non può cambiare la propria immagine, quindi esegui tu l’immagine precedente e HolyArrs ripristina i dati precedenti.

Attenzione

Tutto ciò che è cambiato dopo l’aggiornamento, come titoli nuovi, impostazioni e cronologia, non è nel backup di prima dell’aggiornamento.

1. Cambia il tag dell’immagine nel tuo file compose (o in docker run) con quello precedente, per esempio holyarrs/holyarrs:<older version>.
2. Esegui docker compose up -d.
3. Se l’aggiornamento non aveva cambiato i dati, la versione precedente si avvia. Hai finito.
4. Altrimenti la versione precedente mostra una pagina al posto dell’app. Premi Put back the data from before the update (ripristina i dati di prima dell’aggiornamento).
5. Scrivi il codice monouso. Lo trovi con docker logs <container>; cerca “one-time code”.
6. HolyArrs controlla il backup, lo rimette al suo posto e si ferma. Dovresti vedere il container ripartire su quei dati grazie al suo criterio di riavvio. Se non ne ha uno, avvialo tu.

Senza la pagina: docker exec <container> /holyarrs restore --pre-update, poi docker restart <container>. Senza Docker: arresta HolyArrs, esegui holyarrs restore --pre-update, avvialo.

Non viene cancellato nulla. I dati più recenti vengono spostati in backups/before-restore-<time>/, così puoi annullare. Se torni indietro di più di una versione, viene scelto il backup di prima dell’aggiornamento più recente che quella versione sa leggere.

Scelte

Tutto in Settings > Health checks (Impostazioni > Controlli di salute). Le ultime tre stanno nella parte avanzata della scheda.

Impostazione	Predefinito	Cambiala quando
Check for a newer HolyArrs (cerca un HolyArrs più recente)	On	Non vuoi nessuna richiesta verso l’esterno
Check for updates every (cerca aggiornamenti ogni)	giorno	Vuoi meno controlli: 3, 7, 14 o 30 giorni
Release feed (feed delle versioni)	Vuoto (versioni di HolyArrs)	Ospiti un tuo feed
Feed may be on the local network (il feed può essere nella rete locale)	Off	Il tuo feed è nella tua rete
Include test versions (like 1.2.0-rc1) (includi versioni di prova)	Off	Vuoi gli avvisi per le versioni di prova

Se non funziona

Sintomo: “The last check did not work.” Causa: il server non ha internet, oppure il tuo feed è nella rete locale. Soluzione: controlla l’accesso a internet, oppure attiva Feed may be on the local network.

Sintomo: il feed delle versioni non si salva. Causa: l’indirizzo contiene un nome utente, una password, una ?query o un #fragment, oppure non inizia con http:// o https://. Soluzione: togli quelle parti.

Sintomo: l’aggiornamento si è fermato per mancanza di spazio sul disco. Causa: non c’è posto per la copia e per l’aggiornamento. Soluzione: libera spazio dove si trova la cartella di configurazione, poi riavvia.

Sintomo: la pagina per tornare indietro rifiuta il tuo codice. Causa: un codice vecchio, oppure 10 codici sbagliati dall’ultimo avvio. Soluzione: copia il codice dall’ultima riga del log. Dopo 10 tentativi sbagliati, riavvia il container e usa il nuovo codice.

Funzioni in sospeso

Alcune funzioni sono disattivate per impostazione predefinita in questa versione. Attivale a tuo rischio. Finché sono in sospeso, le loro pagine e voci di menu sono nascoste, le loro route API rispondono “not found” e i loro processi non girano. I dati che hai salvato per loro restano.

Per attivarne una, aggiungi il suo interruttore a HOLYARRS_FLAGS, separato da virgole, e riavvia il container:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Togli il nome e riavvia per disattivarla. Le impostazioni nascoste tornano quando la riattivi.

Interruttore	Funzione
plex_watchlists	Le watchlist di Plex diventano richieste
row_title_stats	Statistiche dei titoli nelle righe di Esplora, in Appearance
trakt_lists	Chiave Trakt, liste Trakt e recensioni Trakt. Le liste TMDB restano attive
alert_channels_more	Avvisi Telegram, ntfy, Gotify, Pushover e webhook. Discord e email restano attivi
subtitle_sites	Siti di sottotitoli e ricerca dei sottotitoli. La tua lingua dei sottotitoli resta attiva
emby_signin	Accesso con Emby. L’aggiornamento della Libreria di Emby funziona ancora
go_back	Il pannello Go back (torna indietro) nella pagina Stato. I passaggi in Tornare indietro funzionano anche senza

Non è cambiato niente dopo aver aggiunto un interruttore? Controlla come è scritto (minuscolo, con trattini bassi) e riavvia il container, non solo la pagina.

Per esperti

Cosa invia il controllo

Una sola richiesta a api.github.com per l’ultima versione, con il solo User-Agent: HolyArrs/<version>. Nessun account, chiave o elenco di media. Con il controllo disattivato, nessuna richiesta.

L’ultima risposta viene salvata, quindi un riavvio non controlla prima del tempo. Un controllo aspetta al massimo 15 s, legge al massimo 512 KB e segue al massimo 3 reindirizzamenti, senza mai passare da http a https o viceversa. Il link alle note di versione compare solo se punta alle pagine delle versioni di HolyArrs su GitHub; altrimenti la versione appare come testo semplice.

Release feed accetta una risposta di release in stile GitHub, un elenco di release, qualsiasi JSON con version, o testo semplice che contiene la versione. Gli indirizzi dei metadati cloud vengono sempre rifiutati. Una versione di prova conta come più vecchia della versione normale.

Il backup prima di un aggiornamento

Prima di cambiare i dati salvati, HolyArrs:

1. Controlla che ci sia posto per una copia e per l’aggiornamento. Se non c’è, non cambia nulla. Salta il controllo con HOLYARRS_SKIP_SPACE_CHECK=yes.
2. Copia ogni database in backups, controlla la copia e scrive accanto un file sha256. Dopo 3 copie fallite, non cambia nulla.
3. Esegue ogni passaggio di aggiornamento da solo e lo controlla. Un passaggio fallito viene annullato; quelli finiti restano. Avvia di nuovo la stessa versione per continuare dal passaggio fallito con la stessa copia.

Dopo il primo avvio riuscito la copia diventa holyarrs-backup-pre-update-<time>.zip, descritta come “before updating from 1.1.0 to 1.2.0”. Compare in Settings > Backups e in holyarrs restore --list. Si tengono le 3 più recenti; la pianificazione dei backup non le rimuove mai. Un’installazione nuova o un aggiornamento che non tocca i dati non ne crea.

Correlati

• Backup
• Controlli di salute
• Parti e modalità sicura