# Solução de problemas

Siga o caminho na ordem: processo do posto → caixa de correio → pasta inscrita → canal de entrega → telefone. Um teste de canal ignora o monitoramento da caixa de correio; uma nova mensagem verifica todo o caminho.

## O posto ou o console estão inacessíveis

Verificar `docker compose ps` e `docker compose logs --tail=100 core` . A ligação localhost é intencional; use um túnel SSH ou um [Proxy HTTPS](https.md) funcional de outro dispositivo. Verifique as permissões de volume gravável quando a inicialização reportar `data_directory_permission_denied` ou `data_directory_read_only` . O contêiner é executado como usuário `10001:10001` .

## Código de configuração ou senha do administrador

Até que a configuração seja concluída, cada reinicialização do posto rotaciona o código de configuração. Leia os logs do processo atual. Para redefinir uma senha de administrador, interrompa o posto e use o mesmo projeto do Compose e volume de dados:

```sh
docker compose stop core
docker compose run --rm -it core admin reset-password
docker compose start core
```

A redefinição interativa desconecta sessões do navegador e preserva tokens de API, caixas de correio e trabalhos em fila. O comando de recuperação utiliza o bloqueio do diretório de dados, portanto, o posto em execução deve ser interrompido.

## Uma nova mensagem não produz notificação

1. Verifique a conexão da caixa de correio e as credenciais IMAP.
2. Verifique se a pasta exata do servidor está inscrita. Uma nova assinatura ignora mensagens antigas.
3. Permita que o intervalo programado selecionado passe ou inspecione a conexão em tempo real.
4. Inspecione o histórico de entrega. Se não houver evento, investigue o monitoramento. Se um evento falhar, inspecione o erro do canal.
5. Envie um teste de canal. Para o aplicativo Mailwake, verifique o telefone de recebimento selecionado e o direito de push comum.

Uma contagem de novas tentativas igual a 0 significa uma tentativa. Aumente-o deliberadamente antes de esperar novas tentativas automáticas. O status aceito de um canal confirma a aceitação do serviço; inspecione o provedor downstream e o telefone em busca de problemas de exibição.
A conexão do aplicativo

## Falha na conexão do aplicativo

Abra primeiro o endereço HTTPS do posto no Safari. Verifique o certificado e o roteamento, crie um novo convite de cinco minutos e compare a impressão digital criptográfica do posto. Um erro `clock_skew` requer a sincronização do relógio do host do posto. Verifique se o proprietário concedeu as permissões necessárias e se o Pro está ativo para ações que o exijam.

Se o telefone foi revogado, selecione um novo telefone receptor e salve o canal. Após alterar o ambiente do serviço de envio de notificações, use a redefinição do operador documentada em [Implantação](deploy.md) e emparelhe novamente; as identidades ambientais permanecem separadas.

## Peça ajuda

Use [Problemas do GitHub](https://github.com/mingzaily/mailwake/issues) para bugs reproduzíveis de postos avançados. Inclui versão, código de erro, tempo e diagnóstico redigido do console. Mantenha senhas, tokens de API, links de convite e conteúdo de mensagens fora dos relatórios públicos. Relate problemas de segurança usando [SEGURANÇA.md](https://github.com/mingzaily/mailwake/blob/main/SECURITY.md).