Troubleshooting
| Problem | Fix |
|---|---|
| AI can't connect, or the model is missing | In Settings → AI, press Save to re-run setup. 401: API key. 404: address or model. Timeout: server unreachable — for a shared server, check the port and that it listens on 0.0.0.0 |
| LM Studio: command-line tool isn't set up | Open the LM Studio app once, then Retry |
| LM Studio: model list is empty | Start its server: lms server start, or from LM Studio's Developer tab |
| LM Studio: first reply takes a minute | Normal — it loads the model on demand |
| Search finds nothing, or is stale | Let the first indexing finish, or Settings → AI → Recompute embeddings now |
| Asks for a passphrase you don't recognise | The data folder holds another database. Enter its passphrase, or switch folders in Settings → Data |
| "Database credentials missing" | crypto_header.json is gone. Restore it or choose the right data folder |
| macOS: "Not Opened" or "Apple could not verify" | Open the app once and click Done, then System Settings → Privacy & Security → Open Anyway. Or in Terminal: xattr -dr com.apple.quarantine "/Applications/Mindmap Chat.app" |
| Linux: blank canvas | KDE + NVIDIA on X11: log in to a Plasma (Wayland) session |
| Linux (Snap): black window | The Snap cannot reach some GPU drivers. Install the .deb instead |
| Fedora KDE: Discover hangs on "Refreshing Snap" | A Discover bug (KDE 500513). Run sudo dnf remove plasma-discover-snap and add excludepkgs=plasma-discover-snap to /etc/dnf/dnf.conf |
Anything else: Settings → About → Send feedback, or [email protected].