Fehlerbehebung
Nach Symptom suchen; sonst App Einstellungen → Hilfe & Feedback → Problem-Feedback (Screenshot + Problemlogs) oder Feedback-E-Mail. Bitte angeben: OS, Tool (Ollama / LM Studio / KoboldCPP …), Base URL (IP-Endsegmente maskierbar), Originalfehler.
Verbindung / Test
| Symptom | Mögliche Ursache | Fix |
|---|---|---|
| Timeout | anderes Wi‑Fi, Firewall, Dienst nicht auf 0.0.0.0 | gleiches Netz; Port freigeben; «Dienst / LAN»-Kapitel des Tools |
| Sofort fehlgeschlagen | falsche IP/Port, Dienst aus | am PC http://IP:Port/v1/models; Base URL prüfen |
| localhost scheitert | localhost auf dem Handy = Handy selbst | LAN-IP des PCs |
| 401 / Key-Fehler | manche lokalen Stacks prüfen Key | nicht-leerer Platzhalter oder Auth laut Tool-Doku aus |
| 404 / Modell fehlt | Name ≠ lokal | ollama list oder /v1/models — volle id |
| Antwort, aber Chat leer/Fehler | Kompatibilität, Timeout, Modell nicht geladen | Timeout hoch; Modell load; kleineres Modell zum Pfadtest |
Netz & System
| Symptom | Mögliche Ursache | Fix |
|---|---|---|
| PC ok, Handy nicht | Gast-Wi‑Fi / AP-Isolation | Hauptnetz; Hotspot vom Handy, PC daran |
| Sporadisch weg | PC-Schlaf, IP-Wechsel | Schlaf aus; IP neu und Verbindung aktualisieren |
| Mit VPN seltsam | Split / virtuelle Adapter | VPN testweise aus oder LAN ausschließen |
URL-Schreibweise
| Richtig | Falsch |
|---|---|
http://192.168.1.8:11434/v1 | http://localhost:11434/v1 |
http://192.168.1.8:1234/v1 | http://192.168.1.8:1234/v1/chat/completions |
http://192.168.1.8:5001/v1 | https://192.168.1.8:11434/v1 (ohne Zertifikat kein erzwungenes https) |
http://192.168.1.8:8080/v1 |
Klartext-HTTP
MiniTavern Android erlaubt Klartext-HTTP (üblich im LAN). Wenn trotzdem blockiert:
- Base URL ist
http://, nicht falsches Protokoll - System-/Hersteller-Netzschutz blockiert LAN nicht
- iOS bei ATS: LAN-Adresse laut Doku; weiter fehlgeschlagen → OS-Version und Fehler melden
CORS
CORS betrifft vor allem Browser-Seiten; native Apps zum API meist nicht. Browser-Frontend am PC ≠ MiniTavern — App-interner Test gilt.
Performance
| Symptom | Fix |
|---|---|
| Erstes Token sehr langsam | kleinere Quantisierung/Parameter; GPU prüfen |
| Hängt mitten in der Generierung | Timeout hoch; andere VRAM-Apps zu; PC-Logs auf OOM |