Solução de problemas

Ache seu sintoma, leia a causa, siga a solução. Os exemplos usam o nome de container holyarrs; use o seu se for diferente.

Primeiras 3 verificações

1. Acompanhe o log: docker logs -f holyarrs. Os segredos aparecem mascarados. Aperte Ctrl+C para parar de acompanhar; o container continua em execução.
2. Execute o doctor: docker exec holyarrs /holyarrs doctor. Cada linha diz OK, WARN ou FAIL, e cada WARN ou FAIL diz como resolver.
3. Ainda travou? Baixe um pacote de suporte e pergunte. Veja Obter suporte.

Não consigo abrir a página web

Sintoma: o navegador não consegue conectar em http://your-server:6262.

Causa: o container está parado, a porta não está mapeada ou há um proxy no caminho.

Solução:

1. Execute docker ps. Você deve ver holyarrs com 0.0.0.0:6262->6262.
2. Se ele fica reiniciando, leia o motivo em docker logs holyarrs.
3. Se você usa um caminho como /holyarrs, veja Proxy reverso e URL base.

Permissão negada

Sintoma: o doctor diz que uma pasta não aceita escrita, ou as importações falham com um erro de permissão.

Causa: o proprietário da pasta no host não bate com PUID e PGID.

Solução: execute o chown que o doctor sugere, ou defina PUID e PGID com o proprietário da pasta. Em um NAS, dê a esse usuário leitura e escrita na tela de permissões. Veja NAS, Synology e Unraid.

Nada baixa

Sintoma: os títulos continuam faltando e nada chega ao seu gerenciador de downloads.

Causa: nenhuma Fonte responde, o gerenciador de downloads não está conectado ou nenhum lançamento passa nas suas Regras de escolha.

Solução:

1. Abra Settings > Downloaders (Configurações > Gerenciadores de downloads) e clique em Test (Testar) no seu gerenciador de downloads. O teste deve passar.
2. Abra Settings > Sources (Configurações > Fontes) e clique em Test em cada Fonte.
3. No título, abra Choose a release (Escolher um lançamento) para ver todos os resultados e os motivos de cada um não ter sido escolhido.

Veja Gerenciadores de downloads e Fontes.

Baixou, mas não importou

Sintoma: o download terminou no seu gerenciador de downloads, mas o título não está na sua Biblioteca.

Causa: o HolyArrs não vê o arquivo no mesmo caminho, não consegue escrever na pasta da Biblioteca ou a importação precisa de uma decisão.

Solução:

1. Dê ao HolyArrs e ao gerenciador de downloads a mesma pasta de downloads no mesmo caminho, como /downloads, ou defina Downloader’s path (caminho do gerenciador de downloads) e HolyArrs’ path (caminho do HolyArrs) no gerenciador de downloads.
2. Execute o doctor e resolva qualquer FAIL nas pastas de downloads ou da Biblioteca.
3. Veja se a lista de downloads tem itens marcados com Needs a decision (Precisa de uma decisão) e aprove ou descarte o plano.

As importações são cópias, não hardlinks

Sintoma: o doctor diz que hardlinks (links físicos) não funcionam, ou o uso do disco dobra depois das importações.

Causa: as pastas de downloads e da Biblioteca estão em discos ou montagens diferentes.

Solução: monte uma única pasta-mãe compartilhada no container em vez de pastas separadas. Veja Pastas.

O HolyArrs não inicia

Sintoma: o container para ou reinicia na hora.

Causa: o log diz qual é. As mais comuns: /config em um compartilhamento de rede ou caminho FUSE, ou uma Parte quebrada.

Solução:

1. Mova /config para um disco local se o log pedir. O HolyArrs não executa seu banco de dados em um compartilhamento.
2. Caso contrário, inicie em Modo de segurança, conserte em Settings (Configurações) e reinicie normalmente.

Falta um recurso

Sintoma: um recurso sobre o qual você leu não está no app.

Causa: ele pode estar retido nesta versão.

Solução: veja Recursos retidos.

As páginas estão sem nomes ou imagens

Sintoma: os títulos aparecem sem pôsteres ou detalhes.

Causa: o servidor de metadados está inacessível.

Solução: verifique seu DNS e seu firewall. A seção de rede do doctor mostra se o servidor responde.

Para especialistas

Verificações e opções do doctor

O doctor é executado dentro do container com o mesmo usuário do HolyArrs, então ele esbarra no que o HolyArrs esbarra.

Seção	Mostra
App	Versão, usuário e grupo, umask, se está em um container.
Pasta de configuração	Proprietário, permissões, espaço livre, se está em um disco local.
Pastas da Biblioteca e de downloads	Se existe, proprietário, se aceita escrita, espaço livre, hardlinks entre as pastas de downloads e da Biblioteca.
Rede	Se o nome do servidor de metadados resolve e se ele responde.
Relógio	Hora, fuso horário (TZ), um aviso quando o relógio está claramente errado.

Opção	O que faz
-config <folder>	Verifica outra pasta de configuração do HolyArrs em vez de /config.
-json	Imprime o relatório em JSON.

Código de saída 0 quer dizer que nada falhou; 1 quer dizer que uma linha diz FAIL. O relatório nunca mostra chaves, senhas ou tokens. Ele só lê, a não ser por um pequeno arquivo de teste que escreve e remove. Iniciado como root, ele também entrega a pasta de configuração a PUID:PGID, como em uma inicialização normal.

Se o HolyArrs fica reiniciando, docker exec falha. Execute o doctor em um container novo com as mesmas pastas:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Com o Compose: docker compose run --rm holyarrs doctor.

Verificação de pastas na inicialização

Ao iniciar, o HolyArrs verifica suas pastas e escreve no log uma linha de resumo, como folders: 4 ok, 1 not writable, e depois uma linha por pasta com problema, com a solução. A verificação para depois de 3 segundos, para a inicialização nunca travar. Uma pasta lenta demais para responder conta como não verificada; em geral é um disco saindo do repouso ou um compartilhamento de rede lento. O doctor verifica essa pasta sem o limite de tempo. Veja Logs.

A imagem não tem shell

A imagem tem só o programa do HolyArrs, então fica pequena e deixa menos para um invasor. docker exec holyarrs sh falha de propósito. Para olhar mais de perto, inicie um auxiliar descartável ao lado:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Ele vê o processo do HolyArrs, compartilha a rede dele e tem as mesmas pastas nos mesmos caminhos. Ele é executado como root, então olhe, mas não altere: um arquivo escrito como root pode ficar ilegível para o HolyArrs. Para testar como o usuário do HolyArrs, adicione --user <PUID>:<PGID>.

Descobrir a versão

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

A seção App do doctor mostra a mesma coisa.

Relacionados

• Obter suporte
• Logs
• Verificações de saúde