Perguntas frequentes e solução de problemas
Perguntas gerais
Quais servidores o gyokuro suporta?
Gitea e Forgejo — auto-hospedados, com quantas instâncias você quiser ao mesmo tempo.
O gyokuro funciona com certificados autoassinados ou atrás de um proxy?
Sim. O gyokuro suporta certificados autoassinados, mTLS, proxies HTTP/SOCKS, cabeçalhos HTTP próprios e Basic Auth — pensado exatamente para esse tipo de configuração de homelab.
Como eu recebo notificações push?
Pela sua própria instância ntfy ou Gotify — self-hosted até o fim. Também há notificações locais e um relatório semanal opcional.
Meus dados de acesso são enviados para algum lugar?
Não. Tokens e dados de acesso ficam exclusivamente no Chaveiro do iOS no seu aparelho. Sem nuvem, sem rastreamento de terceiros.
Solução de problemas
O login falha
O log ao vivo durante o login mostra cada etapa da verificação de conexão — ali você vê na hora se o problema é a URL, o certificado ou o token. Verifique também se o token tem as permissões necessárias.
Meu servidor exige autenticação para a API
Servidores que só permitem acesso à API com autenticação são suportados desde a versão 2.1 — atualize o app.
As execuções ou os logs das Actions não aparecem
As Gitea Actions precisam estar ativadas no servidor (na configuração do servidor e no repositório em questão). Sem as Actions ativadas, a seção fica vazia.
O push via ntfy/Gotify não chega
Verifique a URL e o tópico da sua própria instância nos ajustes e dê uma olhada nos filtros de notificação — eles podem ser restringidos por repositório e por tipo.
Erro de certificado ao conectar
Com certificados autoassinados, você precisa permitir o certificado explicitamente nos ajustes de servidor do app, ou configurar mTLS/cabeçalhos próprios de acordo.