Troubleshoot
Find by symptom. If still stuck: App Settings → Help & feedback → Report an issue (screenshots and issue logs welcome), or the feedback email. Include: OS, tool (Ollama / LM Studio / KoboldCPP, etc.), Base URL (you may mask the last two IP octets), and the exact error text.
Connection / Test
| Symptom | Likely cause | Fix |
|---|---|---|
| Timeout | Not same Wi‑Fi, firewall blocking port, service not on 0.0.0.0 | Same network; allow port; follow each tool’s “start server / LAN” chapter |
| Instant fail / cannot connect | Wrong IP/port, service off | On PC open http://IP:port/v1/models; check Base URL |
localhost still fails | On the phone, localhost is the phone | Use the PC LAN IP |
| 401 / key error | A few local stacks validate Key | Any non-empty placeholder, or disable auth per that tool’s docs |
| 404 / model not found | Name mismatch | Copy the full id from ollama list or /v1/models |
| Response but empty chat / error | Compatibility, short timeout, model not loaded | Raise timeout; confirm model loaded; try a smaller model |
Network and system
| Symptom | Likely cause | Fix |
|---|---|---|
| PC works, phone does not | Guest Wi‑Fi / AP isolation | Use main network; or phone hotspot with PC joined |
| Occasional disconnect | PC sleep, IP changed | Prevent sleep; re-check IP and update the link |
| Breaks with VPN on | Routing / virtual NIC | Disable VPN for the test or exclude LAN |
URL format
| Correct | Incorrect |
|---|---|
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 (do not force https without local certs) |
http://192.168.1.8:8080/v1 |
Cleartext HTTP
MiniTavern Android allows cleartext HTTP (common on LAN). If still blocked:
- Confirm Base URL is
http://, not a wrong scheme - Confirm OS / vendor network protection is not blocking LAN
- On iOS ATS issues, prefer the LAN address in the docs; if it still fails, report OS version and error
CORS
CORS mainly affects browser pages; native App → API is usually not affected by CORS. If a browser front-end on the PC fails, that does not mean MiniTavern will — trust in-App Test.
Performance
| Symptom | Fix |
|---|---|
| First token very slow | Smaller quant / params; confirm GPU is used |
| Stalls mid-generation | Raise timeout; close other VRAM users; check PC logs for OOM |