Troubleshooting and FAQ

Troubleshooting & FAQ

Troubleshooting

Apricity loads but the palace is empty {#empty-palace}

The UI renders, but the counters read 0 and the list is empty.

• Confirm ~/.mempalace/palace/chroma.sqlite3 exists. If it doesn't, MemPalace itself hasn't been initialised on this machine — file at least one memory through MemPalace first.
• If your palace lives elsewhere, set MEMPALACE_PALACE_DB and MEMPALACE_KG_DB to the correct absolute paths and restart.
• Check the server log — Apricity prints the exact paths it tried to open.

Saves/deletes fail with "mempalace package not found" {#writes-fail}

Reads work, but every write fails with a subprocess error mentioning ModuleNotFoundError: No module named 'mempalace'.

• MEMPALACE_PYTHON_BIN points at a Python that can't import mempalace. Test it:

  $MEMPALACE_PYTHON_BIN -c "import mempalace; print(mempalace.__file__)"

• Fix the path, or install mempalace into that venv, then restart Apricity.

I forgot my password

rm ~/.mempalace/dashboard-credentials.json ~/.mempalace/dashboard-sessions.json

Restart and re-enroll via Settings → Account. This does not touch your memories.

Port 8765 is already in use

PORT=9000 python3 server.py

A save "succeeded" then reverted

That's the optimistic-save safety net: the UI applied your edit instantly, the server rejected it (often an ETag conflict — the memory changed underneath you), so it rolled back. Reopen the memory to get the current version, then re-apply your edit. Use the retry affordance if offered.

Notifications aren't making a sound

Browsers block audio until you interact with the page. Click or press a key once to unlock it, then use Settings → Notifications → Test notification. Also check that Mute notification sound and Suppress notifications are off.

The front-end looks broken after an edit to app.js

Apricity minifies JavaScript at serve time. To rule the minifier out while debugging, set MEMPALACE_NO_MINIFY=1 and restart.

FAQ

Is this an official MemPalace project? No. Apricity is a community front-end that talks to the official mempalace package. MemPalace itself lives at MemPalace/mempalace.

Does it work offline? Yes. The server is loopback-only and the front-end is vendored — no CDNs, no analytics. The only outbound call is an optional, cached check of the GitHub releases API to tell you when a new Apricity version exists.

Do my memories leave my machine? Never. Apricity reads and writes only files under $MEMPALACE_HOME. There's no network code in the data path.

Can I run more than one instance? Yes — give each its own PORT, and (for isolated palaces) its own MEMPALACE_HOME.

Why no required pip install? The whole server is one file of standard-library Python. Keeping it dependency-free means you can audit it, vendor it, or run it on a fresh box without worrying about supply chains. The pip/pipx package exists only so installing it is one command.

Does it keep a full edit history? No — by design. The versions log is for recovering deletions. Edits are protected from accidental overwrite by ETag concurrency but aren't snapshotted as a running history.

Can I reach it from my phone / another computer? It binds to 127.0.0.1 deliberately. Put a reverse proxy or Tailscale in front of it — never expose the raw port. See Security & Safety.

---

Still stuck? Open an issue on the repo.