# Upgrades

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

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](https://zerowidth.ai/docs/self-hosting/exports)

Run `doctor` after an upgrade to check the setup.