Domande frequenti e risoluzione dei problemi
Domande generali
Quali server supporta gyokuro?
Gitea e Forgejo — self-hosted, con quante istanze vuoi contemporaneamente.
gyokuro funziona anche con certificati autofirmati o dietro un proxy?
Sì. gyokuro supporta certificati autofirmati, mTLS, proxy HTTP/SOCKS, header HTTP personalizzati e Basic Auth — pensato proprio per questo tipo di configurazioni da homelab.
Come ottengo le notifiche push?
Tramite la tua istanza ntfy o Gotify — self-hosted fino in fondo. In più ci sono le notifiche locali e un riepilogo settimanale opzionale.
I miei dati di accesso vengono caricati da qualche parte?
No. Token e dati di accesso restano esclusivamente nel portachiavi di iOS sul tuo dispositivo. Nessun cloud, nessun tracciamento di terze parti.
Risoluzione dei problemi
L'accesso fallisce
Il log in diretta durante l’accesso mostra ogni passaggio della verifica di connessione — lì vedi subito se il problema è nell’URL, nel certificato o nel token. Controlla anche che il token abbia i permessi necessari.
Il mio server richiede l'autenticazione per l'API
I server che consentono l’accesso alle API solo con autenticazione sono supportati dalla versione 2.1 — aggiorna l’app.
I run di Actions o i log non vengono visualizzati
Gitea Actions deve essere attivo sul server (nella configurazione del server e nel rispettivo repository). Senza Actions attivo la sezione resta vuota.
Le push tramite ntfy/Gotify non arrivano
Controlla URL e topic della tua istanza nelle impostazioni e dai un’occhiata ai filtri delle notifiche — si possono limitare per repository e tipo.
Errore di certificato durante la connessione
Con i certificati autofirmati devi consentire esplicitamente il certificato nelle impostazioni del server dell’app, oppure configurare di conseguenza mTLS o header personalizzati.