Migrar de outros apps

Traga a configuração dos seus apps anteriores para o HolyArrs sem digitar tudo de novo.

O HolyArrs só lê os apps anteriores. Nada muda neles, e seus arquivos de mídia nunca saem do lugar.

Antes de começar

• Entre como dono ou administrador.
• Tenha em mãos o endereço e a chave de API de cada app anterior.
• Confira se o HolyArrs enxerga suas pastas de mídia. Veja Pastas e hardlinks.

Migrar sua configuração

1. Abra Settings > Move from other apps (Configurações > Migrar de outros apps). Você deve ver cinco passos em uma linha no topo.
2. Read (ler): clique em Add an app (adicionar um app) para cada app anterior. Você deve ver cada app na lista, com uma chave.
3. Choose (escolher): ative os grupos que você quer trazer.
4. Try it (testar): confira o que vai ser adicionado. Nada muda ainda.
5. Move (migrar): clique em Move e confirme. Você pode sair da página enquanto a migração acontece.
6. Done (concluído): você deve ver os resultados por grupo e Undo this move (desfazer esta migração).

Chaves e senhas nunca vêm junto. Veja Depois da migração.

Em que ordem fazer

Ordem	App	Por que nesta ordem
1	Radarr, Sonarr	As pastas da Biblioteca e os títulos vêm primeiro. Veja Sonarr e Radarr.
2	Lidarr, Prowlarr, Bazarr	Música, Fontes e idiomas das legendas. Veja Lidarr, Bazarr e Prowlarr.
3	qBittorrent, SABnzbd	Gerenciadores de downloads. Leia os dois na mesma migração dos apps acima.
4	Seerr, Overseerr	Pessoas e pedidos, ligados aos títulos que já estão aqui. Veja Apps de pedidos.

Você pode ler todos os apps e migrar tudo de uma vez. A ordem só importa se você migrar em partes.

Depois da migração

Cada item abaixo chega pausado ou desativado. Digite o segredo do item, confira e depois ative.

Item	Onde	O que fazer
Fontes	Settings > Sources (Configurações > Fontes)	Digite a chave e depois retome.
Gerenciadores de downloads	Settings > Downloaders (Configurações > Gerenciadores de downloads)	Digite a senha ou a chave e depois retome.
Alertas	Settings > Alerts (Configurações > Alertas)	Digite o link ou a senha do e-mail e depois ative.
Listas externas	Settings > Outside lists (Configurações > Listas externas)	Confira a pasta e as Regras de escolha e depois ative. Uma lista do Trakt precisa antes da sua chave do Trakt.
Pessoas	Settings > Users and roles (Configurações > Usuários e funções)	Envie os convites.

Uma Fonte, um Gerenciador de downloads ou um Alerta que tinha tags no app anterior agora atende todos os títulos do seu tipo. Confira antes de ativar.

As Fontes e os Gerenciadores de downloads chegam com May reach the local network (pode acessar a rede local) desativado. Ative só para o que fica na sua rede de casa. Os endereços link-local e os de metadados de nuvem continuam bloqueados de qualquer jeito.

Para digitar várias chaves de uma vez, veja Importar chaves de um arquivo.

O que fica para trás

• Arquivos de mídia. A migração nunca move, renomeia, copia nem exclui um arquivo.
• Chaves, senhas, tokens e cookies. O passo Move e o relatório listam cada um em Keys to type again (chaves para digitar de novo).
• Configurações sem equivalente aqui. Cada uma aparece na lista not moved (não migrado), com o motivo.
• Histórico. O HolyArrs não lê o histórico dos apps anteriores. A pessoa que pediu um título vem junto.

Se não funcionar

Sintoma	Causa	Solução
Títulos aparecem como não encontrados	A pasta deles não corresponde a uma pasta da Biblioteca aqui.	Adicione uma regra de caminho em Advanced (avançado), dentro de Choose, e migre de novo.
O Move diz que o plano mudou	Alguma coisa mudou depois do teste.	Execute Try it de novo e depois migre.
O botão de migrar está cinza	Uma pessoa precisa de uma escolha, ou o HolyArrs está no Modo de segurança.	Leia o texto ao lado do botão.
Alguns itens falharam	Por exemplo, o servidor de metadados estava fora do ar.	Espere e migre de novo. O HolyArrs guarda as chaves dos seus apps anteriores.

Para especialistas

Migrar de novo, desfazer, Partes e Modo de segurança

Migrar de novo. Uma migração lembra o que adicionou. Migrar de novo adiciona só o que é novo e mostra already here (já está aqui) para o resto. Só uma migração ou um desfazer acontece por vez. Se o HolyArrs parar no meio de uma migração, ela fica marcada como falha no próximo início, ou continua se a tarefa dela ainda estiver na fila. Ela nunca trava a próxima migração.

Earlier moves (migrações anteriores), abaixo das leituras, lista todas as migrações e o estado de cada uma. Open (abrir) mostra uma migração no passo 5, ou no passo 4 enquanto ela acontece.

Desfazer. Clique em Undo this move no passo 5 (para uma migração mais antiga, clique antes em Open). O desfazer acontece em segundo plano e remove só o que aquela migração adicionou, do mais novo para o mais antigo:

• os títulos saem da Biblioteca; os arquivos deles ficam onde estão,
• as Fontes, os Gerenciadores de downloads, os Alertas, os sites de legendas, as pessoas, os pedidos e as entradas da Lista de nunca adicionar que ela adicionou são removidos,
• as Listas externas que ela adicionou são removidas se ainda estiverem pausadas,
• os nomes de arquivo, os idiomas padrão das legendas e as esperas das Regras de escolha voltam ao que eram.

O que você configurou ou mudou depois da migração fica, e o relatório do desfazer lista tudo: um segredo que você digitou, uma pessoa ou uma Lista externa que você ativou, nomes de arquivo, idiomas ou esperas que você mudou. As pastas da Biblioteca que tinham títulos ficam, porque os títulos removidos mantêm o Histórico.

Partes. Uma Parte desativada fica de fora. Filmes desativado: nenhuma pasta de filmes, nenhum filme, nenhuma Lista externa. Legendas desativado: nenhuma configuração de legendas. Pedidos desativado: nenhum pedido.

Modo de segurança. Você pode ler, escolher e testar, mas não migrar nem desfazer.

API

As chaves de API precisam do escopo admin.

Rota	O que faz
POST /api/v1/migrate/plan	O plano para as leituras escolhidas, com as contagens e as regras de caminho sugeridas.
POST /api/v1/migrate/dry-run	O relatório do teste e o plan_hash dele. Nada muda. Uma pessoa que precisa de uma escolha vem com choose definido como same_name, numeric_id ou merge_gone.
POST /api/v1/migrate/moves	Inicia uma migração. Precisa do plan_hash do teste. Responde 409 quando o plano mudou.
GET /api/v1/migrate/moves	Lista as migrações, da mais nova para a mais antiga.
GET /api/v1/migrate/moves/{id}	Uma migração, com o relatório e o progresso.
GET /api/v1/migrate/moves/{id}/report	O relatório como arquivo Markdown.
POST /api/v1/migrate/moves/{id}/undo	Coloca o desfazer na fila (202). Acompanhe com GET /api/v1/migrate/moves/{id}.

Corpo de plan, dry-run e moves (moves também recebe "plan_hash"):

{
  "snapshots": [1, 2],
  "path_rules": [{"from": "/data/media/movies", "to": "/movies"}],
  "skip": ["alerts"],
  "people": {"person:seerr:1": "owner", "person:seerr:3": "admin", "person:seerr:2": "merge"}
}

A escolha para uma pessoa é owner (só o dono do app anterior), admin, merge ou skip. Grupos que você pode pular: folders, pick_rules, titles, never_add, outside_lists, sources, downloaders, naming, subtitles, people, wishlist, alerts.

Páginas desta seção

Página	Use para
Sonarr e Radarr	Trazer pastas, séries, filmes e as regras deles. Faça isto primeiro.
Lidarr, Bazarr e Prowlarr	Trazer música, idiomas das legendas e Fontes.
Seerr e Overseerr	Trazer pessoas e pedidos em aberto.
Ler seus apps anteriores	Ver exatamente o que o HolyArrs lê e guarda.
Importar chaves de um arquivo	Digitar várias chaves de uma vez.

Relacionados

• Primeira execução
• Glossário