FAQ & Troubleshooting
Allgemeine Fragen
Welche Server unterstützt gyokuro?
Gitea und Forgejo — selbst gehostet, mit beliebig vielen Instanzen gleichzeitig.
Funktioniert gyokuro auch mit selbstsignierten Zertifikaten oder hinter einem Proxy?
Ja. gyokuro unterstützt selbstsignierte Zertifikate, mTLS, HTTP-/SOCKS-Proxys, eigene HTTP-Header und Basic Auth — gedacht für genau solche Homelab-Setups.
Wie bekomme ich Push-Benachrichtigungen?
Über deine eigene ntfy- oder Gotify-Instanz — self-hosted bis zum Schluss. Zusätzlich gibt es lokale Benachrichtigungen und einen optionalen Wochenbericht.
Werden meine Zugangsdaten irgendwo hochgeladen?
Nein. Tokens und Zugangsdaten liegen ausschließlich im iOS-Schlüsselbund auf deinem Gerät. Keine Cloud, kein Tracking.
Fehlerbehebung
Die Anmeldung schlägt fehl
Das Live-Log bei der Anmeldung zeigt jeden Schritt der Verbindungsprüfung — dort siehst du sofort, ob es an URL, Zertifikat oder Token liegt. Prüfe auch, ob der Token die nötigen Berechtigungen hat.
Mein Server verlangt eine Anmeldung für die API
Server, die API-Zugriffe nur mit Authentifizierung erlauben, werden seit Version 2.1 unterstützt — bitte App aktualisieren.
Actions-Runs oder Logs werden nicht angezeigt
Gitea Actions müssen am Server aktiviert sein (in der Server-Konfiguration und im jeweiligen Repository). Ohne aktivierte Actions bleibt der Bereich leer.
Push über ntfy/Gotify kommt nicht an
Prüfe URL und Topic der eigenen Instanz in den Einstellungen und wirf einen Blick auf die Benachrichtigungs-Filter — die lassen sich pro Repository und Typ einschränken.
Zertifikatsfehler beim Verbinden
Bei selbstsignierten Zertifikaten musst du das Zertifikat in den Server-Einstellungen der App explizit erlauben, oder mTLS/eigene Header entsprechend konfigurieren.