Troubleshooting

Common problems and how to fix them. Pick a category below — each entry follows the same shape: a short description of what you’re seeing, then what to do about it.

If your problem isn’t here, the app version and a description of the steps that reproduce it are usually enough to file a useful bug report at github.com/ztcs-software/loach/issues.

Categories

• Providers & connectionsOllama unreachable, OpenAI 401, empty model lists, Linux key storage issues.
• Sending & receiving messagesStuck “waiting” chats, half-streamed replies, missing thinking traces or token counts, off-topic answers.
• Performance & VRAMOut-of-memory crashes, sluggish UI, slow first reply after launch.
• AttachmentsFile-too-large errors, empty scanned PDFs, legacy DOCX, truncation footers, vision-only images.
• Web fetch & MCPIgnored URLs, blocked internal hosts, failed fetches and MCP handshake errors.
• Spaces & memoryMissing memory entries, bad facts, reference file caps, Space-instruction overrides.
• App lockForgotten PINs, rate-limited unlocks, re-authentication prompts after unlock.
• Models editorModelfile validation errors, stuck pulls, delete failures.
• UpdatesMissing install buttons on Linux, stale “up to date” messages, signature failures.
• Data, import & exportRejected JSON imports, scope of “Wipe user data” vs “Factory reset”.
• Appearance & windowAurora tearing on integrated GPUs, partial font-size scaling.
• Search paletteCtrl+K doing nothing during onboarding or lock screen.
• PlatformmacOS Gatekeeper warning on first launch, Credential Manager access denied on managed Windows machines.