Ler seus apps anteriores

Leia a configuração de um app anterior, pelo próprio app ou pelo backup dele, como passo 1 de uma migração. Ler não muda nada no HolyArrs nem no app anterior.

Uma read (leitura) é a cópia que o HolyArrs faz da configuração de um app. Ela fica guardada até você migrar ou remover.

Ler um app

1. Abra Settings > Move from other apps (Configurações > Migrar de outros apps) e clique em Add an app (adicionar um app).
2. Escolha o app e depois Through the app (pelo app) ou From a backup (de um backup).
3. Clique em Check connection (verificar conexão). Você deve ver o app e a versão em poucos segundos.
4. Inicie a leitura. Uma biblioteca grande leva alguns minutos. Stop reading (parar a leitura) interrompe a leitura; fechar o painel não interrompe.
5. Você deve ver a leitura na lista. Adicione o próximo app do mesmo jeito.

Edit (editar) em uma linha lê aquele app de novo. Remove (remover) joga a leitura fora.

Opções

Pelo app

Digite o endereço e a chave de API do app. Para o qBittorrent, digite o nome de usuário e a senha, ou a chave de API dele na versão 5.2 ou mais nova.

Os apps anteriores geralmente ficam na sua rede de casa, então ative a chave da rede local para a leitura. Os endereços de metadados de nuvem continuam bloqueados, e o app não pode redirecionar o HolyArrs para outro endereço.

De um backup

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

• um zip de backup do Radarr, Sonarr, Lidarr, Prowlarr ou Bazarr,
• a pasta de configuração do Seerr, Overseerr, qBittorrent ou SABnzbd,
• um arquivo de banco de dados ou de configurações.

As leituras feitas de um backup não salvam nenhuma chave.

O que é lido

App	O que é lido
Radarr, Sonarr, Lidarr	Todos os filmes, séries (com temporadas) ou artistas: ids, pasta, marca de monitorado, perfil de qualidade, tags, data em que foi adicionado. Também as pastas da Biblioteca, tags, perfis de qualidade, formatos personalizados, regras de palavras de lançamento, regras de espera, nomes de arquivo, indexadores, clientes de download, listas, notificações, gravadores de metadados, exclusões, perfis de idioma (Sonarr v3), perfis de metadados (Lidarr) e o atraso de disponibilidade do Radarr.
Prowlarr	Indexadores, vínculos com apps, perfis de sincronização, proxies de indexador, clientes de download, notificações.
Bazarr	Idiomas ativados, perfis de idioma, sites de legendas ativados, perfis padrão.
qBittorrent, SABnzbd	Endereço, porta, nome de usuário, pastas de download, categorias e (SABnzbd) servidores Usenet.
Seerr, Overseerr	Pessoas (nome, e-mail, função, permissões, limites de pedidos), limites padrão e todos os pedidos aguardando ou aprovados: quem pediu, quando e o quê. Os pedidos concluídos e os recusados são só contados. Os avatares não são lidos.

Ler mais do que se migra é de propósito: tudo o que foi lido e não migrado aparece na lista not moved (não migrado), com o motivo.

Chaves e senhas

Uma leitura nunca guarda chave, senha, token ou cookie, mesmo quando um backup traz isso em texto puro. Cada um aparece em needs re-entry (precisa ser digitado de novo), por exemplo indexer "Nyaa": apiKey.

Links contam como segredos, porque tokens se escondem neles. Os links de notificação, os endereços de feeds RSS e os parâmetros extras em texto livre ficam para trás e aparecem na lista. Um endereço de indexador mantém só o host e o caminho da API.

A chave que você digitou

Quando o dono lê um app com uma chave digitada, o HolyArrs guarda esse endereço e essa chave no armazenamento criptografado dele. Da próxima vez, Edit lê de novo com Use the saved key (usar a chave salva) ativado, e a chave vai só para o endereço salvo. O HolyArrs nunca mostra a chave.

A chave salva é excluída quando
você remove a leitura daquele app
uma migração termina sem nenhuma falha (um item com falha mantém as chaves, para você poder migrar de novo)
você executa holyarrs import-secrets -forget-move-credentials

Quem pode ler

O dono e os administradores, depois de entrar com a senha. A dispensa de login na rede local não conta. Uma chave de API precisa do escopo admin.

Se não funcionar

Sintoma	Causa	Solução
Check connection falha	O endereço é testado a partir do servidor do HolyArrs.	Use um endereço que o servidor consegue acessar. Ative a chave da rede local para um app na rede de casa.
A chave está errada	Erro ao copiar, ou o qBittorrent quer um nome de usuário.	Copie a chave de novo nas configurações do app anterior.
Um backup é recusado	O zip foi alterado, ou o caminho está fora do container.	Use o zip de backup do próprio app, sem alterações, no caminho dele dentro do container do HolyArrs.
A leitura é grande demais	Limites por leitura e por servidor.	Remova as leituras antigas de que você não precisa mais.

Para especialistas

Tratamento de backups e limites

Regra	Valor
Arquivos copiados	Só os arquivos necessários, para uma pasta temporária privada, excluída depois da leitura.
Tamanho por arquivo copiado	1 GB no máximo.
config.xml de um app arr	Nunca é copiado; ele guarda a chave de API.
Banco de dados	Aberto como somente leitura.
Recusado por inteiro quando	uma entrada aponta para fora do zip, ele contém um link, ou um arquivo fica muito maior que o tamanho dele ao ser descompactado.
Backups ao mesmo tempo	1.
Guardado por leitura	16 MB.
Leituras guardadas	As 50 mais novas.

API

Rota	O que faz
POST /api/v1/migrate/probe	Diz qual app e qual versão responde, ou qual backup é este.
POST /api/v1/migrate/read	Lê a configuração inteira e guarda.
GET /api/v1/migrate/snapshots	Lista as leituras, da mais nova para a mais antiga.
GET /api/v1/migrate/snapshots/{id}	Uma leitura com tudo o que ela contém.
DELETE /api/v1/migrate/snapshots/{id}	Remove uma leitura e a chave salva para aquele app.
GET /api/v1/migrate/saved-keys	Os apps com chave salva e os endereços deles, nunca a chave. Só o dono.
DELETE /api/v1/migrate/saved-keys	Exclui todas as chaves salvas, ou uma com ?kind=. Só o dono.

O corpo de probe e de read informa o app: radarr, sonarr, lidarr, prowlarr, bazarr, seerr, overseerr, qbittorrent ou sabnzbd. Adicione url com key (ou username e password), ou path. Adicione allow_local_network para acessar sua rede de casa e use_saved_key para usar a chave salva.

Relacionados

• Migrar de outros apps
• Importar chaves de um arquivo