User guide

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].