Partes e modo de segurança

Desativa as partes que não usas, inicia em modo de segurança quando algo avaria e reinicia o HolyArrs a partir do 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). Escolhe-as pela primeira vez no assistente da primeira execução.

1. Abre Settings > Parts (Definições > Partes).
2. Clica em Turn on (ativar) ou Turn off (desativar) ao lado de uma parte. Deves ver os itens do menu dela aparecerem ou desaparecerem.

Nada é apagado. Ativa a parte outra vez e ela retoma onde ficou.

Iniciar em modo de segurança

O modo de segurança inicia só o essencial, para quando algo impede o HolyArrs de arrancar ou de funcionar. Podes iniciar sessão, ver a tua Biblioteca, alterar definições e fazer ou restaurar uma cópia de segurança. Pesquisar, adicionar, atualizar, transferir e importar esperam pelo próximo arranque normal.

1. Abre Settings > Danger zone (Definições > Zona de perigo).
2. Clica em Restart in safe mode (reiniciar em modo de segurança). Deves ver um banner em todas as páginas.
3. Resolve o problema e depois clica em Restart HolyArrs (reiniciar o HolyArrs). O arranque seguinte é normal.

Se não consegues chegar à página, define HOLYARRS_SAFE_MODE=1 no Compose ou arranca com -safe-mode. Remove-o depois da correção: ambos mantêm todos os arranques 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, pesquisar, atualizar	As transferências que já estão no teu gestor de transferências continuam a ser acompanhadas. Os ficheiros ficam.
Séries	Páginas de séries, adicionar, pesquisar, pesquisas de temporadas, atualizações	Igual aos Filmes.
Música	Páginas de artistas e álbuns, definições de música, atualizações de artistas, pesquisas de álbuns	Igual aos Filmes.
Legendas	Definições de legendas, a página de legendas em falta, pesquisas e verificações	Os ficheiros de legendas junto dos teus vídeos ficam.
Pedidos	Páginas de pedidos e pedir títulos	Os pedidos existentes ficam e voltam quando a parte for reativada.

Sempre ativos: início de sessão e contas, pastas da Biblioteca, fontes, gestores de transferências e transferências, avisos, histórico, cópias de segurança, verificações de saúde, definições e a API.

• As legendas precisam de Filmes ou Séries. Os pedidos precisam de Filmes, Séries ou Música. O HolyArrs recusa uma alteração que quebre isto e diz o que mudar primeiro.
• Uma tarefa em fila de uma parte desativada espera e corre quando a parte for ativada.
• Desativar uma parte não poupa memória. Tudo corre num só programa.

Reiniciar, pôr em pausa e desligar

Settings > Danger zone (proprietário e administradores) tem Restart HolyArrs, Restart in safe mode e Shut down (desligar), mais Pause (pausa), Resume (retomar) e Restart (reiniciar) para cada tarefa em segundo plano, como as cópias de segurança ou a sincronização de transferências.

• Os controlos que param alguma coisa pedem-te confirmação em 60 s.
• Cada controlo usado fica escrito no Histórico com o teu nome.
• Precisas de um início de sessão com palavra-passe. Um início de sessão sem palavra-passe na tua rede local é recusado.

Reiniciar para o HolyArrs de forma limpa e deixa o Docker iniciá-lo outra vez, por isso define 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	Desativa primeiro essa parte, como diz a mensagem.
Reiniciar desligou o HolyArrs de vez	A política de reinício é no	Inicia o contentor e define restart: unless-stopped.
Os controlos são recusados	Início de sessão local sem palavra-passe, ou a chave não tem control	Inicia sessão com a tua palavra-passe.
Uma tarefa continua falhada	Precisa de ti	Lê o motivo dela em /health, resolve-o e clica em Restart nessa tarefa.

Mais soluções: Resoluçã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 ligada com um estado e um motivo.

Estado	Significado
off	Desativada, em pausa, ou não iniciada em modo de segurança.
starting	A iniciar, ou ainda não verificada.
running	Funciona.
retrying	Falhou; o HolyArrs tenta de novo, esperando mais de cada vez.
failed	Falhou, está presa ou precisa de ti. O motivo diz o que fazer.

Uma tarefa que falhou mostra failed, depois retrying, e depois arranca outra vez. O início de sessão, a Biblioteca e as cópias de segurança continuam a funcionar entretanto. Uma tarefa presa resolve-se com um reinício completo.

Memória e modo de pouca memória

O HolyArrs procura ficar abaixo de 384 MiB, o que cabe num limite de contentor de 500 MB. Para definires o teu próprio objetivo, define GOMEMLIMIT para cerca de 80 por cento da memória do contentor.

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

Definição	Efeito
(predefinição, Linux)	Ativa-se sozinho com cerca de 2.5 GiB de memória ou menos.
HOLYARRS_LOW_MEMORY=1	Sempre ativo.
HOLYARRS_LOW_MEMORY=0	Sempre desativado.

A primeira linha do registo diz se está ativo e porquê.

Âmbitos das chaves de API

Cria uma chave em Settings > API > API keys (Definições > API > Chaves de API) e envia-a no cabeçalho X-Api-Key.

Âmbito	Chega a
read	Biblioteca, tarefas, transferências, histórico, saúde, definições. Segredos ocultados.
health_read	Só os estados de saúde. Para ferramentas de monitorização.
write	Todas as alterações, exceto as rotas de administração e os controlos.
admin	Pessoas, convites, limites de pedidos, chaves de API, palavra-passe e autenticação de dois fatores, definições de início de sessão, cópias de segurança.
control	Os controlos desta página. Só o proprietário e os administradores a podem conceder.
all	read, write e admin. Não control.

Uma chave nunca faz mais do que a pessoa que a criou. Os âmbitos não se podem mudar depois; cria uma chave nova. Todas as rotas e o seu âmbito: /api/v1/openapi.json.

Relacionado

• Verificações de saúde
• Cópias de segurança
• Rotas da API