Upgrade
You can upgrade Pulse without deleting data when the /data volume or ~/.okto-pulse directory is preserved. Treat data preservation as the first rule.
Minor version upgrades
For pip installs:
For Docker:
Schema migrations
Read the release notes before major upgrades. SQLite migrations run at startup. KG schema migrations can be triggered separately when needed.
KG schema migration
Use the MCP tool or module command:
Do not delete graph.lbug files to force a migration. Use schema migration, backfill, or dead-letter reprocess tools.
Rollback strategy
Before upgrading, snapshot the SQLite database and graph files. Roll back by restoring the previous image/package and the preserved data snapshot.
Related pages
