> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrade

> Upgrade Pulse without losing SQLite data, uploads, or Knowledge Graph files.

# 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:

```bash theme={null}
pip install --upgrade okto-pulse
```

```text theme={null}
Successfully installed okto-pulse
```

For Docker:

```bash theme={null}
docker compose pull
docker compose up -d
```

```text theme={null}
Container okto-pulse started
```

## 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:

```text theme={null}
okto_pulse_kg_migrate_schema(board_id="...")
```

```bash theme={null}
python -m okto_pulse.tools.kg_migrate_schema --board <board_id>
```

<Warning>
  Do not delete `graph.lbug` files to force a migration. Use schema migration, backfill, or dead-letter reprocess tools.
</Warning>

## 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

* [Backfill and dedup](/kg-operations/backfill)
* [KG health](/kg-operations/health)
* [Docker operations](/operations/docker)