Self-hosting

Upgrades

Update ZeroWidth and start serve again. Your record moves to the new layout the first time the new version opens the record.

View as Markdown

Stop serve, and any zerowidth mcp processes your AI tools keep open. Then update ZeroWidth and start serve again.

Terminal

npm i -g @zerowidth/cli@latest
zerowidth serve --db team.db

Restart your AI tools, or reconnect ZeroWidth in each tool, so each one starts the new version.

The record's layout

A record written by an older version moves to the newer layout the first time the newer version opens the record. When an upgrade needs the old file kept, ZeroWidth keeps a copy beside the record, such as team.db.before-v1, and says where.

While that copy exists, withhold --yes refuses, because the copy still holds every word. Delete the copy once the upgrade looks right, or pass --keep-backup. Exports

Run doctor after an upgrade to check the setup.