Partes e modo de segurança

Desative as Partes que você não usa, inicie em modo de segurança quando algo quebrar e reinicie o HolyArrs pelo navegador.

Ativar ou desativar uma Parte

O HolyArrs tem 5 Partes: Movies (filmes), TV shows (séries), Music (música), Subtitles (legendas) e Requests (pedidos). Você escolhe as Partes pela primeira vez no assistente da primeira execução.

1. Abra Settings > Parts (configurações > partes).
2. Clique em Turn on (ativar) ou Turn off (desativar) ao lado de uma Parte. Você deve ver os itens de menu dela aparecerem ou sumirem.

Nada é excluído. Ative a Parte de novo e ela continua de onde parou.

Iniciar em modo de segurança

O modo de segurança inicia só o básico, para quando algo impede o HolyArrs de iniciar ou de funcionar. Você pode entrar, ver sua Biblioteca, mudar configurações e fazer ou restaurar um backup. Buscar, adicionar, atualizar dados, baixar e importar esperam a próxima inicialização normal.

1. Abra Settings > Danger zone (configurações > zona de perigo).
2. Clique em Restart in safe mode (reiniciar em modo de segurança). Você deve ver uma faixa em todas as páginas.
3. Resolva o problema e depois clique em Restart HolyArrs (reiniciar o HolyArrs). A próxima inicialização é normal.

Se você não consegue chegar à página, defina HOLYARRS_SAFE_MODE=1 no Compose ou inicie com -safe-mode. Remova depois de resolver: os dois mantêm toda inicialização em modo de segurança.

Opções

O que para quando uma Parte está desativada

Parte	Para	Continua
Filmes	Páginas e itens de menu de filmes, adicionar, buscar, atualizar dados	Os downloads que já estão no seu gerenciador de downloads continuam sendo acompanhados. Os arquivos ficam.
Séries	Páginas de séries, adicionar, buscar, buscas de temporada, atualizações de dados	Igual a Filmes.
Música	Páginas de artistas e álbuns, configurações de música, atualizações de artistas, buscas de álbuns	Igual a Filmes.
Legendas	Configurações de legendas, a página de legendas que faltam, buscas e verificações	Os arquivos de legenda ao lado dos seus vídeos ficam.
Pedidos	Páginas de pedidos e pedir títulos	Os pedidos existentes ficam e voltam quando a Parte é ativada de novo.

Sempre ativos: login e contas, pastas da Biblioteca, Fontes, gerenciadores de downloads e downloads, alertas, Histórico, backups, verificações de saúde, configurações e a API.

• Legendas precisa de Filmes ou Séries. Pedidos precisa de Filmes, Séries ou Música. O HolyArrs recusa uma mudança que quebre isso e diz o que mudar antes.
• Uma tarefa na fila de uma Parte desativada espera e roda quando a Parte é ativada.
• Desativar uma Parte não economiza memória. Tudo roda em um programa só.

Reiniciar, pausar e desligar

Settings > Danger zone (dono e administradores) tem Restart HolyArrs, Restart in safe mode e Shut down (desligar), além de Pause (pausar), Resume (retomar) e Restart (reiniciar) para cada tarefa em segundo plano, como os backups ou a sincronização de downloads.

• Os controles que param alguma coisa pedem confirmação em até 60 s.
• Todo controle usado é registrado no Histórico com seu nome.
• Você precisa de um login com senha. Um login sem senha na sua rede local é recusado.

Reiniciar para o HolyArrs de forma limpa e deixa o Docker iniciar de novo, então defina restart: unless-stopped.

Política de reinício	Reiniciar	Desligar
unless-stopped ou always	Volta	Volta também
on-failure	Volta	Fica parado
no	Fica parado	Fica parado

Se não funcionar

Sintoma	Causa	Solução
O HolyArrs não consegue desativar uma Parte	Outra Parte precisa dela	Desative essa outra Parte antes, como a mensagem diz.
Reiniciar desligou o HolyArrs de vez	A política de reinício é no	Inicie o container e defina restart: unless-stopped.
Os controles são recusados	Login local sem senha, ou a chave não tem control	Entre com sua senha.
Uma tarefa continua como failed	Ela precisa de você	Leia o motivo em /health, resolva e clique em Restart nessa tarefa.

Mais soluções: Solução de problemas.

Para especialistas

Estados de saúde

/health, Settings > Parts e GET /api/v1/health/states listam cada tarefa em segundo plano, Parte e app vinculado com um estado e um motivo.

Estado	Significado
off	Desativado, pausado ou não iniciado no modo de segurança.
starting	Iniciando, ou ainda não verificado.
running	Funciona.
retrying	Falhou; o HolyArrs tenta de novo, esperando mais a cada vez.
failed	Travou, ficou preso ou precisa de você. O motivo diz o que fazer.

Uma tarefa que travou aparece como failed, depois retrying, e então inicia de novo. O login, a Biblioteca e os backups continuam funcionando enquanto isso. Uma tarefa presa se resolve com um reinício completo.

Memória e modo de pouca memória

O HolyArrs procura ficar abaixo de 384 MiB, o que cabe em um limite de container de 500 MB. Para definir sua própria meta, defina GOMEMLIMIT como cerca de 80 por cento da memória do container.

O modo de pouca memória guarda menos coisas na memória e lê mais do banco de dados. Algumas páginas demoram um instante a mais, e o trabalho em segundo plano, como a cópia do catálogo de música, roda com menos frequência.

Configuração	Efeito
(padrão, Linux)	Ativa sozinho com cerca de 2.5 GiB de memória ou menos.
HOLYARRS_LOW_MEMORY=1	Sempre ativado.
HOLYARRS_LOW_MEMORY=0	Sempre desativado.

A primeira linha do log diz se ele está ativado e por quê.

Escopos das chaves de API

Crie uma chave em Settings > API > API keys (configurações > API > chaves de API) e envie no cabeçalho X-Api-Key.

Escopo	Alcança
read	Biblioteca, tarefas, downloads, histórico, saúde, configurações. Segredos mascarados.
health_read	Só os estados de saúde. Para ferramentas de monitoramento.
write	Toda mudança, menos as rotas de admin e os controles.
admin	Pessoas, convites, limites de pedidos, chaves de API, senha e verificação em duas etapas, configurações de login, backups.
control	Os controles desta página. Só o dono e os administradores podem conceder.
all	read, write e admin. Não control.

Uma chave nunca faz mais do que a pessoa que a criou. Os escopos não podem ser mudados depois; crie uma chave nova. Todas as rotas e seus escopos: /api/v1/openapi.json.

Relacionados

• Verificações de saúde
• Backups
• Rotas da API