Lettura delle app precedenti

Leggi la configurazione di un’app precedente, tramite l’app o da un suo backup, come primo passaggio di un trasferimento. La lettura non cambia nulla in HolyArrs né nell’app precedente.

Una read (lettura) è la copia che HolyArrs fa della configurazione di una singola app. Resta finché non la sposti o la rimuovi.

Leggi un’app

1. Apri Settings > Move from other apps (Impostazioni > Passare da altre app) e fai clic su Add an app (aggiungi un’app).
2. Scegli l’app, poi Through the app (tramite l’app) o From a backup (da un backup).
3. Fai clic su Check connection (controlla la connessione). Dovresti vedere l’app e la versione entro pochi secondi.
4. Avvia la lettura. Una Libreria grande richiede qualche minuto. Stop reading (interrompi la lettura) la ferma; chiudere la finestra no.
5. Dovresti vedere la lettura nell’elenco. Aggiungi l’app successiva allo stesso modo.

Edit (modifica) su una riga rilegge quell’app. Remove (rimuovi) butta via la lettura.

Scelte

Tramite l’app

Scrivi l’indirizzo e la chiave API dell’app. Per qBittorrent scrivi nome utente e password, oppure la sua chiave API dalla versione 5.2 in poi.

Le app precedenti di solito stanno nella tua rete di casa, quindi attiva l’interruttore della rete locale per la lettura. Gli indirizzi dei metadati cloud restano bloccati e l’app non può reindirizzare HolyArrs a un altro indirizzo.

Da un backup

Scrivi il percorso completo, sul server di HolyArrs, di uno di questi:

• uno zip di backup di Radarr, Sonarr, Lidarr, Prowlarr o Bazarr,
• la cartella di configurazione di Seerr, Overseerr, qBittorrent o SABnzbd,
• un singolo file di database o di impostazioni.

Le letture da un backup non salvano nessuna chiave.

Cosa viene letto

App	Cosa viene letto
Radarr, Sonarr, Lidarr	Ogni film, serie (con le stagioni) o artista: id, cartella, indicatore di seguito, profilo di qualità, tag, data di aggiunta. Inoltre cartelle della Libreria, tag, profili di qualità, custom format, regole sulle parole delle release, regole di attesa, denominazione, indexer, client di download, liste, notifiche, scrittori di metadati, esclusioni, profili linguistici (Sonarr v3), profili dei metadati (Lidarr) e il ritardo di disponibilità di Radarr.
Prowlarr	Indexer, collegamenti alle app, profili di sincronizzazione, proxy degli indexer, client di download, notifiche.
Bazarr	Lingue attivate, profili linguistici, siti di sottotitoli attivati, profili predefiniti.
qBittorrent, SABnzbd	Indirizzo, porta, nome utente, cartelle di download, categorie e (SABnzbd) server Usenet.
Seerr, Overseerr	Persone (nome, email, ruolo, permessi, limiti di richieste), limiti predefiniti e ogni richiesta in attesa o approvata: chi l’ha fatta, quando, per cosa. Le richieste concluse e rifiutate vengono solo contate. Gli avatar non vengono letti.

Leggere più di quanto si sposta è voluto: tutto ciò che viene letto ma non spostato compare nell’elenco not moved (non spostato) con il suo motivo.

Chiavi e password

Una lettura non conserva mai una chiave, una password, un token o un cookie, nemmeno quando un backup li contiene in chiaro. Ognuno è elencato sotto needs re-entry (da riscrivere), per esempio indexer "Nyaa": apiKey.

I link contano come segreti, perché i token si nascondono lì dentro. I link delle notifiche, gli indirizzi dei feed RSS e i parametri extra in testo libero vengono lasciati indietro ed elencati. L’indirizzo di un indexer conserva solo l’host e il percorso API.

La chiave che hai scritto

Quando il proprietario legge un’app con una chiave scritta, HolyArrs conserva quell’indirizzo e quella chiave nel suo archivio cifrato. La volta dopo, Edit rilegge con Use the saved key (usa la chiave salvata) attivo, e la chiave va solo all’indirizzo salvato. HolyArrs non la mostra mai.

La chiave salvata viene eliminata quando
rimuovi la lettura di quell’app
un passaggio finisce senza errori (una voce fallita conserva le chiavi, così puoi spostare di nuovo)
esegui holyarrs import-secrets -forget-move-credentials

Chi può leggere

Il proprietario e gli amministratori, con accesso tramite password. L’esenzione dall’accesso sulla rete locale non conta. Una chiave API richiede lo scope admin.

Se non funziona

Sintomo	Causa	Soluzione
Check connection fallisce	L’indirizzo viene provato dal server di HolyArrs.	Usa un indirizzo che il server raggiunge. Per un’app nella rete di casa, attiva l’interruttore della rete locale.
La chiave è sbagliata	Errore di copia, oppure qBittorrent vuole un nome utente.	Copia di nuovo la chiave dalle impostazioni dell’app precedente.
Un backup viene rifiutato	Lo zip è stato modificato, oppure il percorso è fuori dal container.	Usa lo zip di backup dell’app, senza modifiche, al suo percorso dentro il container di HolyArrs.
La lettura è troppo grande	Limiti per lettura e per server.	Rimuovi le vecchie letture che non ti servono più.

Per esperti

Gestione dei backup e limiti

Regola	Valore
File copiati	Solo quelli necessari, in una cartella temporanea privata, eliminata dopo la lettura.
Dimensione per file copiato	1 GB al massimo.
config.xml di un’app arr	Mai copiato; contiene la chiave API.
Database	Aperto in sola lettura.
Rifiutato per intero quando	una voce punta fuori dallo zip, contiene un link, oppure un file si decomprime molto più grande della sua dimensione.
Backup alla volta	1.
Conservato per lettura	16 MB.
Letture conservate	Le 50 più recenti.

API

Route	Cosa fa
POST /api/v1/migrate/probe	Dice quale app e versione risponde, o di quale backup si tratta.
POST /api/v1/migrate/read	Legge tutta la configurazione e la conserva.
GET /api/v1/migrate/snapshots	Elenca le letture, dalla più recente.
GET /api/v1/migrate/snapshots/{id}	Una lettura con tutto ciò che contiene.
DELETE /api/v1/migrate/snapshots/{id}	Rimuove una lettura e la chiave salvata per quell’app.
GET /api/v1/migrate/saved-keys	App con una chiave salvata e i loro indirizzi, mai la chiave. Solo il proprietario.
DELETE /api/v1/migrate/saved-keys	Elimina tutte le chiavi salvate, oppure una con ?kind=. Solo il proprietario.

Il corpo di probe e read indica l’app: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent o sabnzbd. Aggiungi url con key (oppure username e password), o path. Aggiungi allow_local_network per raggiungere la tua rete di casa e use_saved_key per usare la chiave salvata.

Correlati

• Passare da altre app
• Importare le chiavi da un file