Preguntas frecuentes y solución de problemas
Preguntas generales
¿Qué servidores admite gyokuro?
Gitea y Forgejo — autoalojados, con tantas instancias simultáneas como quieras.
¿Funciona gyokuro también con certificados autofirmados o detrás de un proxy?
Sí. gyokuro admite certificados autofirmados, mTLS, proxys HTTP/SOCKS, cabeceras HTTP propias y autenticación básica — pensado justo para este tipo de configuraciones de homelab.
¿Cómo consigo notificaciones push?
A través de tu propia instancia de ntfy o Gotify — self-hosted hasta el final. Además hay notificaciones locales y un informe semanal opcional.
¿Se suben mis datos de acceso a algún sitio?
No. Los tokens y datos de acceso se guardan exclusivamente en el llavero de iOS de tu dispositivo. Sin nube, sin seguimiento de terceros.
Solución de problemas
El inicio de sesión falla
El registro en directo del inicio de sesión muestra cada paso de la comprobación de conexión — ahí ves al instante si el problema está en la URL, el certificado o el token. Comprueba también si el token tiene los permisos necesarios.
Mi servidor exige inicio de sesión para la API
Los servidores que solo permiten el acceso a la API con autenticación son compatibles desde la versión 2.1 — actualiza la app.
No se muestran las ejecuciones de Actions ni los logs
Gitea Actions debe estar activado en el servidor (en la configuración del servidor y en el repositorio correspondiente). Sin Actions activado, la sección queda vacía.
No llegan los push por ntfy/Gotify
Comprueba la URL y el topic de tu propia instancia en los ajustes y echa un vistazo a los filtros de notificaciones — se pueden limitar por repositorio y tipo.
Error de certificado al conectar
Con certificados autofirmados tienes que permitir el certificado explícitamente en los ajustes del servidor de la app, o configurar mTLS/cabeceras propias en consecuencia.