Fehlerbehebung

Beginne mit dem sichtbaren Symptom. So lässt sich schnell trennen, ob Android, das Netzwerk oder der Hermes-Host die Ursache ist.

• Roter Punkt oder keine Verbindung
• „No reachable endpoint“
• Chat streamt nicht
• Manage oder Voice verlangt eine Anmeldung
• Sitzungen fehlen
• App stürzt beim Start ab

Keine Verbindung

1. Prüfe auf dem Host, ob hermes gateway läuft.
2. Öffne auf dem Telefon http://<host>:8642/health.
3. Prüfe API_SERVER_ENABLED=true und die Firewall.
4. Verwende vom Telefon niemals localhost oder 127.0.0.1; diese Adressen zeigen auf das Telefon selbst.

Kein erreichbarer Endpunkt

Die App hat alle gespeicherten LAN-, Tailscale- und öffentlichen Routen geprüft, aber keine Antwort erhalten. Eine LAN-Adresse funktioniert nur im selben WLAN. Für Tailscale müssen Telefon und Server verbunden sein.

Chat streamt nicht

• Prüfe API-URL und API-Schlüssel.
• Tippe bei einem Fehlerbanner einmal auf Retry.
• Prüfe die Hermes-Serverprotokolle.
• Bei langen lokalen Modellläufen kann Android die Verbindung im Hintergrund trennen; die fertige Antwort wird nach der Wiederverbindung geladen.

Manage und Voice

Manage und Standard-Voice verwenden die Dashboard-Anmeldung, nicht den API_SERVER_KEY. Melde dich einmal im Manage-Bereich an und prüfe, ob das Dashboard vom Telefon erreichbar ist.

Sitzungen fehlen

Der Server muss beim Wechsel der Sitzung erreichbar sein. Große Sitzungen können kurz laden; warte auf die Ladeanzeige, bevor du erneut wechselst.

Startabsturz

Öffne Android Einstellungen → Apps → Hermes-Relay → Speicher und lösche die App-Daten. Richte danach API-URL und Schlüssel erneut ein.

Für Relay-Probleme liefert hermes relay doctor eine schreibgeschützte Diagnose.

Vollständige englische Fehlerbehebung → · Installation →