Leer tus apps anteriores

Lee la configuración de una app anterior, a través de la app o desde su copia de seguridad, como paso 1 de una migración. Leer no cambia nada en HolyArrs ni en la app anterior.

Una lectura es la copia que HolyArrs hace de la configuración de una app. Se guarda hasta que la migras o la quitas.

Leer una app

1. Abre Settings > Move from other apps (Ajustes > Migrar desde otras apps) y haz clic en Add an app (añadir una app).
2. Elige la app y luego Through the app (a través de la app) o From a backup (desde una copia de seguridad).
3. Haz clic en Check connection (comprobar conexión). Deberías ver la app y la versión en pocos segundos.
4. Inicia la lectura. Una biblioteca grande tarda unos minutos. Stop reading (detener la lectura) la detiene; cerrar el panel no.
5. Deberías ver la lectura en la lista. Añade la siguiente app de la misma manera.

Edit (editar) en una fila vuelve a leer esa app. Remove (quitar) descarta la lectura.

Opciones

A través de la app

Escribe la dirección y la clave de API de la app. Para qBittorrent, escribe el nombre de usuario y la contraseña, o su clave de API en la versión 5.2 y posteriores.

Las apps anteriores suelen estar en tu red de casa, así que activa el interruptor de la red local para la lectura. Las direcciones de metadatos de la nube siguen bloqueadas, y la app no puede redirigir a HolyArrs a otra dirección.

Desde una copia de seguridad

Escribe la ruta completa, en el servidor de HolyArrs, de una de estas cosas:

• un zip de copia de seguridad de Radarr, Sonarr, Lidarr, Prowlarr o Bazarr,
• la carpeta de configuración de Seerr, Overseerr, qBittorrent o SABnzbd,
• un solo archivo de base de datos o de ajustes.

Las lecturas desde una copia de seguridad no guardan ninguna clave.

Qué se lee

App	Qué se lee
Radarr, Sonarr, Lidarr	Cada película, serie (con temporadas) o artista: ids, carpeta, marca de supervisión, perfil de calidad, etiquetas, fecha en que se añadió. También carpetas de la biblioteca, etiquetas, perfiles de calidad, formatos personalizados, reglas de palabras de lanzamientos, reglas de espera, nombres de archivo, indexadores, clientes de descarga, listas, notificaciones, escritores de metadatos, exclusiones, perfiles de idioma (Sonarr v3), perfiles de metadatos (Lidarr) y el retraso de disponibilidad de Radarr.
Prowlarr	Indexadores, vínculos con apps, perfiles de sincronización, proxies de indexadores, clientes de descarga, notificaciones.
Bazarr	Idiomas activados, perfiles de idioma, sitios de subtítulos activados, perfiles predeterminados.
qBittorrent, SABnzbd	Dirección, puerto, nombre de usuario, carpetas de descarga, categorías y (SABnzbd) servidores Usenet.
Seerr, Overseerr	Personas (nombre, email, rol, permisos, límites de solicitudes), límites predeterminados y cada solicitud pendiente o aprobada: quién pidió, cuándo y qué. Las solicitudes terminadas y las rechazadas solo se cuentan. Los avatares no se leen.

Leer más de lo que se migra es intencionado: todo lo leído que no se migra aparece en la lista not moved (no migrado) con su motivo.

Claves y contraseñas

Una lectura nunca contiene una clave, una contraseña, un token ni una cookie, aunque una copia de seguridad los tenga en texto plano. Cada uno se enumera en needs re-entry (hay que volver a escribirlo), por ejemplo indexer "Nyaa": apiKey.

Los enlaces cuentan como secretos, porque en ellos se esconden tokens. Los enlaces de notificación, las direcciones de feeds RSS y los parámetros extra de texto libre se dejan atrás y se enumeran. La dirección de un indexador conserva solo su host y la ruta de la API.

La clave que escribiste

Cuando el propietario lee una app con una clave escrita, HolyArrs guarda esa dirección y esa clave en su almacén cifrado. La próxima vez, Edit vuelve a leer con Use the saved key (usar la clave guardada) activado, y la clave solo se envía a la dirección guardada. HolyArrs nunca la muestra.

La clave guardada se borra cuando
quitas la lectura de esa app
una migración termina sin ningún fallo (un elemento fallido conserva las claves, para que puedas migrar otra vez)
ejecutas holyarrs import-secrets -forget-move-credentials

Quién puede leer

El propietario y los administradores, con la sesión iniciada con su contraseña. La opción de saltarse el inicio de sesión en la red local no cuenta. Una clave de API necesita el alcance admin.

Si no funciona

Síntoma	Causa	Solución
Check connection falla	La dirección se prueba desde el servidor de HolyArrs.	Usa una dirección a la que llegue el servidor. Activa el interruptor de la red local para una app de la red de casa.
La clave es incorrecta	Error al copiar, o qBittorrent quiere un nombre de usuario.	Copia otra vez la clave desde los ajustes de la app anterior.
Se rechaza una copia de seguridad	El zip se modificó, o la ruta está fuera del contenedor.	Usa el zip de copia de seguridad de la propia app, sin modificar, en su ruta dentro del contenedor de HolyArrs.
La lectura es demasiado grande	Hay límites por lectura y por servidor.	Quita las lecturas antiguas que ya no necesitas.

Para expertos

Tratamiento de las copias de seguridad y límites

Regla	Valor
Archivos copiados	Solo los archivos necesarios, a una carpeta temporal privada que se borra después de la lectura.
Tamaño por archivo copiado	1 GB como máximo.
config.xml de una app arr	Nunca se copia; contiene la clave de API.
Base de datos	Se abre en solo lectura.
Se rechaza entera cuando	una entrada apunta fuera del zip, contiene un enlace, o un archivo ocupa al descomprimirse mucho más que su tamaño.
Copias de seguridad a la vez	1.
Se guarda por lectura	16 MB.
Lecturas guardadas	Las 50 más recientes.

API

Ruta	Qué hace
POST /api/v1/migrate/probe	Dice qué app y qué versión responde, o qué copia de seguridad es.
POST /api/v1/migrate/read	Lee toda la configuración y la guarda.
GET /api/v1/migrate/snapshots	Enumera las lecturas, de la más reciente a la más antigua.
GET /api/v1/migrate/snapshots/{id}	Una lectura con todo lo que contiene.
DELETE /api/v1/migrate/snapshots/{id}	Quita una lectura y la clave guardada para esa app.
GET /api/v1/migrate/saved-keys	Las apps con clave guardada y sus direcciones, nunca la clave. Solo el propietario.
DELETE /api/v1/migrate/saved-keys	Borra todas las claves guardadas, o una con ?kind=. Solo el propietario.

El cuerpo de probe y de read indica la app: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent o sabnzbd. Añade url con key (o username y password), o path. Añade allow_local_network para llegar a tu red de casa y use_saved_key para usar la clave guardada.

Relacionado

• Migrar desde otras apps
• Importar claves desde un archivo