Llegir les teves apps anteriors

Llegeix la configuració d’una app anterior, a través de l’app o des de la seva còpia de seguretat, com a pas 1 d’una importació. Llegir no canvia res a HolyArrs ni a l’app anterior.

Una read (lectura) és la còpia que HolyArrs fa de la configuració d’una app. Es conserva fins que la importes o l’elimines.

Llegeix una app

1. Obre Settings > Import from other apps (Paràmetres > Importar d’altres apps) i clica a Add an app (afegir una app).
2. Tria l’app i després Through the app (a través de l’app) o From a backup (des d’una còpia de seguretat).
3. Clica a Check connection (comprovar la connexió). Hauries de veure l’app i la versió en pocs segons.
4. Inicia la lectura. Una biblioteca gran triga uns quants minuts. Stop reading (aturar la lectura) l’atura; tancar el full no ho fa.
5. Hauries de veure la lectura a la llista. Afegeix la següent app de la mateixa manera.

Edit (editar) en una fila torna a llegir aquella app. Remove (eliminar) llença la lectura.

Opcions

A través de l’app

Escriu l’adreça i la clau d’API de l’app. Per a qBittorrent, escriu el nom d’usuari i la contrasenya, o la seva clau d’API a partir de la versió 5.2.

Les apps anteriors solen ser a la teva xarxa de casa, així que activa l’interruptor de xarxa local per a la lectura. Les adreces de metadades del núvol continuen bloquejades, i l’app no pot redirigir HolyArrs a una altra adreça.

Des d’una còpia de seguretat

Escriu la ruta completa, al servidor d’HolyArrs, d’una d’aquestes:

• un zip de còpia de seguretat de Radarr, Sonarr, Lidarr, Prowlarr o Bazarr,
• la carpeta de configuració de Seerr, Overseerr, qBittorrent o SABnzbd,
• una base de dades o un fitxer de paràmetres.

Les lectures des d’una còpia de seguretat no desen cap clau.

Què es llegeix

App	Què es llegeix
Radarr, Sonarr, Lidarr	Cada pel·lícula, sèrie (amb temporades) o artista: ids, carpeta, marca de seguiment, perfil de qualitat, etiquetes, data d’afegit. També carpetes de la Biblioteca, etiquetes, perfils de qualitat, formats personalitzats, regles de paraules dels llançaments, regles d’espera, nom dels fitxers, indexadors, clients de descàrrega, llistes, notificacions, escriptors de metadades, exclusions, perfils de llengua (Sonarr v3), perfils de metadades (Lidarr) i el retard de disponibilitat de Radarr.
Prowlarr	Indexadors, enllaços d’apps, perfils de sincronització, proxies d’indexadors, clients de descàrrega, notificacions.
Bazarr	Llengües activades, perfils de llengües, llocs de subtítols activats, perfils per defecte.
qBittorrent, SABnzbd	Adreça, port, nom d’usuari, carpetes de baixades, categories i (SABnzbd) servidors d’Usenet.
Seerr, Overseerr	Persones (nom, email, rol, permisos, límits de sol·licituds), límits per defecte i cada sol·licitud pendent o aprovada: qui l’ha demanada, quan i què. Les sol·licituds acabades i rebutjades només es compten. Els avatars no es llegeixen.

Llegir més del que s’importa és a propòsit: tot el que es llegeix però no s’importa surt a la llista not imported (no importat) amb el seu motiu.

Claus i contrasenyes

Una lectura mai conté una clau, contrasenya, token ni cookie, ni tan sols quan una còpia de seguretat els té en text pla. Cadascun es llista sota needs re-entry (cal tornar a escriure), per exemple indexer "Nyaa": apiKey.

Els enllaços compten com a secrets, perquè hi poden haver tokens amagats. Els enllaços de notificació, les adreces de feeds RSS i els paràmetres extra de text lliure es deixen enrere i es llisten. L’adreça d’un indexador només conserva el host i la ruta de l’API.

La clau que has escrit

Quan el propietari llegeix una app amb una clau escrita, HolyArrs conserva aquella adreça i aquella clau al seu magatzem xifrat. La propera vegada, Edit torna a llegir amb Use the saved key (fer servir la clau desada) activat, i la clau només va a l’adreça desada. HolyArrs mai la mostra.

La clau desada s’esborra quan
elimines la lectura d’aquella app
una importació acaba sense cap error (un element fallit conserva les claus, perquè puguis tornar a importar)
executes holyarrs import-secrets -forget-move-credentials

Qui pot llegir

El propietari i els administradors, amb la sessió iniciada amb la contrasenya. L’accés sense inici de sessió des de la xarxa local no compta. Una clau d’API necessita l’àmbit admin.

Si no funciona

Símptoma	Causa	Solució
Check connection falla	L’adreça es prova des del servidor d’HolyArrs.	Fes servir una adreça que el servidor pugui abastar. Activa l’interruptor de xarxa local per a una app de la xarxa de casa.
La clau és incorrecta	Error en copiar, o qBittorrent vol un nom d’usuari.	Torna a copiar la clau dels paràmetres de l’app anterior.
Es rebutja una còpia de seguretat	El zip s’ha modificat, o la ruta és fora del contenidor.	Fes servir el zip de còpia de seguretat de la pròpia app, sense modificar, a la seva ruta dins del contenidor d’HolyArrs.
La lectura és massa gran	Límits per lectura i per servidor.	Elimina les lectures antigues que ja no necessitis.

Per a experts

Tractament de les còpies de seguretat i límits

Regla	Valor
Fitxers copiats	Només els fitxers necessaris, a una carpeta temporal privada, esborrada després de la lectura.
Mida per fitxer copiat	1 GB com a màxim.
config.xml d’una app arr	Mai es copia; conté la clau d’API.
Base de dades	S’obre només per llegir.
Es rebutja sencer quan	una entrada apunta fora del zip, conté un enllaç, o un fitxer es descomprimeix a una mida molt més gran que la seva.
Còpies de seguretat alhora	1.
Es conserva per lectura	16 MB.
Lectures conservades	Les 50 més noves.

API

Ruta	Què fa
POST /api/v1/migrate/probe	Diu quina app i versió respon, o quina còpia de seguretat és.
POST /api/v1/migrate/read	Llegeix tota la configuració i la conserva.
GET /api/v1/migrate/snapshots	Llista les lectures, de la més nova a la més antiga.
GET /api/v1/migrate/snapshots/{id}	Una lectura amb tot el que conté.
DELETE /api/v1/migrate/snapshots/{id}	Elimina una lectura i la clau desada d’aquella app.
GET /api/v1/migrate/saved-keys	Apps amb una clau desada i les seves adreces, mai la clau. Només el propietari.
DELETE /api/v1/migrate/saved-keys	Esborra totes les claus desades, o una amb ?kind=. Només el propietari.

El cos de probe i read indica l’app: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent o sabnzbd. Afegeix-hi url amb key (o username i password), o path. Afegeix allow_local_network per arribar a la teva xarxa de casa i use_saved_key per fer servir la clau desada.

Relacionat

• Importar d’altres apps
• Importar claus des d’un fitxer