Solução de problemas

Comece pelo sintoma que você consegue ver. Isso separa rapidamente problemas do Android, da rede ou do host do Hermes.

• Ponto vermelho ou sem conexão
• “No reachable endpoint”
• Chat não transmite a resposta
• Manage ou Voice pede login
• Sessões ausentes
• O aplicativo falha ao iniciar

Sem conexão

1. Confirme no host que hermes dashboard está em execução.
2. Abra o endereço do Dashboard/Gateway pelo celular, normalmente http://<host>:9119.
3. Confira o firewall e entre novamente para obter um ticket /api/ws novo.
4. Não use localhost nem 127.0.0.1 no celular; esses endereços apontam para o próprio aparelho.

Nenhum endpoint acessível

O aplicativo testou todas as rotas salvas — LAN, Tailscale e públicas — sem receber resposta. Um endereço LAN funciona somente na mesma rede Wi-Fi. Para Tailscale, o celular e o servidor precisam estar conectados. Uma rota Dashboard como http://100.x.y.z:9119 é testada sem servidor de API nem chave de API. Com o helper recomendado, abra https://<host-do-tailnet>:10443/api/health: o HTTPS :10443 do tailnet encaminha para o Dashboard local :9119.

Chat não transmite

• Confira a URL do Dashboard/Gateway, a sessão e /api/ws.
• Se aparecer um erro, toque em Retry uma vez.
• Verifique os logs do servidor Hermes.
• O API fallback opcional é diagnosticado separadamente; sua falha não bloqueia um Gateway saudável.
• Modelos locais podem levar vários minutos; se o Android interromper a conexão em segundo plano, a resposta concluída será recuperada ao reconectar.

Se o API fallback configurado intencionalmente estiver indisponível, confira API_SERVER_ENABLED, o endereço de bind, http://<host>:8642/health, a chave API_SERVER_KEY criada pelo operador e o firewall. O login do Dashboard não cria essa chave.

Manage e Voice

Manage e a voz padrão usam a sessão do dashboard, não API_SERVER_KEY. Faça login uma vez pelo Manage e confirme que o dashboard está acessível pelo celular.

Sessões ausentes

O servidor precisa estar acessível durante a troca de sessão. Sessões grandes podem levar alguns instantes; aguarde o indicador de carregamento.

Falha ao iniciar

Abra Configurações do Android → Aplicativos → Hermes-Relay → Armazenamento e limpe os dados do aplicativo. Depois configure novamente o endereço e o login do Dashboard/Gateway.

Para problemas do Relay, hermes relay doctor fornece um diagnóstico somente leitura.

Solução completa em inglês → · Instalação →