Reference
Troubleshooting
The problems people hit most, and how to fix them. If yours isn't here, email hello@kept.computer with what you saw.
Kept says the AI engine isn't running
Kept answers with an AI engine that runs on the same Mac. If it has stopped:
- Kept's main window shows a button to open the AI engine. Click it, then ask again.
- If that doesn't help, restart the Mac.
- Still stuck? Settings → Privacy & data → Setup → Run again walks through the engine and model screens again without touching your documents.
Kept says its AI model isn't installed
The model was removed, often by cleaning up disk space. Open Kept on the Mac that runs it; it offers to download the model again. You can also pick a model in Settings → AI model.
Answers are slow
- The first question after a while takes longer: the model has to load into memory.
- Other memory-hungry apps (browsers with many tabs, video editors, virtual machines) slow Kept down. Kept needs 16 GB of memory for a reason.
- Settings → AI model shows the model recommended for your Mac. A larger one than recommended will be slow.
"Not in your documents", but it is
- Ask using the document's own words.
- Check the source on the Sources page. No text means Kept couldn't read it (often a blank or very faint scan): open it on the Mac to check, then Read again.
- For synced folders, check the file isn't in a hidden or tooling folder Kept skips (see syncing).
- See When Kept can't answer for the match setting.
A synced folder isn't updating
- Click Sync now next to the folder.
- If the folder was moved or renamed, Kept can't find it. Stop syncing, then Sync a folder… at its new place.
- Network drives sometimes don't report changes. Sync now works regardless.
Colleagues see "connection isn't private"
Expected the first time, because Kept made its own certificate. Check the fingerprint, then continue. See The certificate warning.
Colleagues can't reach the dashboard
Usually the Mac is asleep, the firewall is blocking Kept, or the .local name doesn't resolve. See If colleagues can't connect.
"This licence is in use on another Mac"
A key works on one Mac at a time. On the other Mac, use Settings → Subscription → Remove licence from this Mac. If that Mac is gone, free the key at kept.computer/account. See Move Kept to another Mac.
"Moved Macs too often this month"
A key can move three times in 30 days. Email hello@kept.computer and we'll sort it out.
API and MCP errors
| You see | Cause | Fix |
|---|---|---|
| Connection refused on port 47822 | The API is off, or Kept isn't open. | Open Kept; turn on Settings → Sharing → Let apps and AI tools on this Mac use Kept. |
401 | Missing, mistyped or revoked key. | Make a new key in Settings → Sharing; check the header is Authorization: Bearer kept_…. |
402 | The trial or subscription has ended. | Subscribe; listing sources still works meanwhile. |
403 | The API is turned off, or the request came from a website or a non-loopback Host. | Call 127.0.0.1 from a tool on the same Mac. |
429 | More than 120 requests, or 20 questions, in a minute for that key. | Wait a minute; give each tool its own key. |
503 | The AI engine isn't running or the model isn't installed. | See the first two sections on this page. |
Full details in the API reference.
Start over
Settings → Privacy & data → Delete… erases everything Kept stored and starts setup again. Your original files aren't touched, and the trial isn't restarted.
Updated November 9, 2026 · Something wrong or missing? Tell us.