Ler as tuas apps anteriores

Lê a configuração de uma app anterior, através da app ou a partir da cópia de segurança, como passo 1 de uma importação. Ler não altera nada no HolyArrs nem na app anterior.

Uma read (leitura) é a cópia que o HolyArrs faz da configuração de uma app. Fica guardada até a importares ou a removeres.

Lê uma app

1. Abre Settings > Import from other apps (Definições > Importar de outras apps) e clica em Add an app (adicionar uma app).
2. Escolhe a app e depois Through the app (através da app) ou From a backup (a partir de uma cópia de segurança).
3. Clica em Check connection (verificar ligação). Deves ver a app e a versão em poucos segundos.
4. Inicia a leitura. Uma biblioteca grande demora alguns minutos. Stop reading (parar a leitura) para-a; fechar a janela não.
5. Deves ver a leitura na lista. Adiciona a app seguinte da mesma maneira.

Edit (editar) numa linha lê essa app outra vez. Remove (remover) deita a leitura fora.

Opções

Através da app

Escreve o endereço e a chave de API da app. No qBittorrent, escreve o nome de utilizador e a palavra-passe, ou a chave de API a partir da versão 5.2.

As apps anteriores costumam estar na tua rede de casa, por isso ativa o interruptor da rede local para a leitura. Os endereços de metadados da cloud ficam bloqueados, e a app não pode redirecionar o HolyArrs para outro endereço.

A partir de uma cópia de segurança

Escreve o caminho completo, no servidor do HolyArrs, de um destes:

• um zip de cópia de segurança do Radarr, Sonarr, Lidarr, Prowlarr ou Bazarr,
• a pasta de configuração do Seerr, Overseerr, qBittorrent ou SABnzbd,
• uma base de dados ou um ficheiro de definições.

As leituras a partir de uma cópia de segurança não guardam nenhuma chave.

O que é lido

App	O que é lido
Radarr, Sonarr, Lidarr	Cada filme, série (com temporadas) ou artista: ids, pasta, indicador de acompanhamento, perfil de qualidade, etiquetas, data de adição. Também pastas da Biblioteca, etiquetas, perfis de qualidade, formatos personalizados, regras de palavras do lançamento, regras de espera, nomenclatura, indexadores, clientes de transferência, listas, notificações, escritores de metadados, exclusões, perfis de idioma (Sonarr v3), perfis de metadados (Lidarr) e o atraso de disponibilidade do Radarr.
Prowlarr	Indexadores, ligações a apps, perfis de sincronização, proxies de indexadores, clientes de transferência, notificações.
Bazarr	Idiomas ativados, perfis de idioma, sites de legendas ativados, perfis predefinidos.
qBittorrent, SABnzbd	Endereço, porta, nome de utilizador, pastas de transferência, categorias e (SABnzbd) servidores Usenet.
Seerr, Overseerr	Pessoas (nome, email, função, permissões, limites de pedidos), limites predefinidos e todos os pedidos em espera ou aprovados: quem pediu, quando, o quê. Os pedidos concluídos e recusados só são contados. Os avatares não são lidos.

Ler mais do que se importa é de propósito: tudo o que é lido mas não importado aparece na lista not imported (não importado) com o motivo.

Chaves e palavras-passe

Uma leitura nunca guarda uma chave, palavra-passe, token ou cookie, mesmo que uma cópia de segurança os tenha em texto simples. Cada um fica listado em needs re-entry (precisa de ser escrito outra vez), por exemplo indexer "Nyaa": apiKey.

As ligações contam como segredos, porque os tokens escondem-se nelas. As ligações de notificações, os endereços de feeds RSS e os parâmetros extra de texto livre ficam para trás e são listados. O endereço de um indexador guarda só o host e o caminho da API.

A chave que escreveste

Quando o proprietário lê uma app com uma chave escrita, o HolyArrs guarda esse endereço e essa chave no seu armazenamento cifrado. Da vez seguinte, Edit lê outra vez com Use the saved key (usar a chave guardada) ativado, e a chave só vai para o endereço guardado. O HolyArrs nunca a mostra.

A chave guardada é apagada quando
removes a leitura dessa app
uma importação termina sem nada falhado (um item falhado mantém as chaves, para poderes importar outra vez)
executas holyarrs import-secrets -forget-move-credentials

Quem pode ler

O proprietário e os administradores, com sessão iniciada com a palavra-passe. O início de sessão dispensado na rede local não conta. Uma chave de API precisa do âmbito admin.

Se não funcionar

Sintoma	Causa	Solução
Check connection falha	O endereço é testado a partir do servidor do HolyArrs.	Usa um endereço que o servidor alcance. Ativa o interruptor da rede local para uma app na rede de casa.
A chave está errada	Erro ao copiar, ou o qBittorrent quer um nome de utilizador.	Copia a chave outra vez das definições da app anterior.
Uma cópia de segurança é recusada	O zip foi alterado, ou o caminho está fora do contentor.	Usa o zip de cópia de segurança da própria app, sem alterações, no caminho que ele tem dentro do contentor do HolyArrs.
A leitura é demasiado grande	Limites por leitura e por servidor.	Remove as leituras antigas de que já não precisas.

Para especialistas

Tratamento de cópias de segurança e limites

Regra	Valor
Ficheiros copiados	Só os ficheiros necessários, para uma pasta temporária privada, apagada depois da leitura.
Tamanho por ficheiro copiado	1 GB no máximo.
config.xml de uma app arr	Nunca é copiado; contém a chave de API.
Base de dados	Aberta só para leitura.
Recusada por inteiro quando	uma entrada aponta para fora do zip, contém uma ligação, ou um ficheiro descomprime para muito mais do que o seu tamanho.
Cópias de segurança em simultâneo	1.
Guardado por leitura	16 MB.
Leituras guardadas	As 50 mais recentes.

API

Rota	O que faz
POST /api/v1/migrate/probe	Diz que app e versão respondem, ou que cópia de segurança é esta.
POST /api/v1/migrate/read	Lê a configuração toda e guarda-a.
GET /api/v1/migrate/snapshots	Lista as leituras, das mais recentes para as mais antigas.
GET /api/v1/migrate/snapshots/{id}	Uma leitura com tudo o que contém.
DELETE /api/v1/migrate/snapshots/{id}	Remove uma leitura e a chave guardada dessa app.
GET /api/v1/migrate/saved-keys	Apps com uma chave guardada e os respetivos endereços, nunca a chave. Só o proprietário.
DELETE /api/v1/migrate/saved-keys	Apaga todas as chaves guardadas, ou uma com ?kind=. Só o proprietário.

O corpo do probe e do read indica a app: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent ou sabnzbd. Junta url com key (ou username e password), ou path. Junta allow_local_network para chegar à tua rede de casa e use_saved_key para usar a chave guardada.

Relacionado

• Importar de outras apps
• Importar chaves de um ficheiro