Update

Pull the latest image, restart, done. Migrations run on boot.

Update to latest

terminal
docker compose pull app
docker compose up -d app

Database schema migrations (the versioned V1 → V15 system) apply automatically on startup. Data in Docker volumes is preserved.

Pin a version

Replace latest in docker-compose.yml with a tag:

docker-compose.yml
image: ghcr.io/mlab-sh/tprm.mlab.sh:v1.3.0

Rollback

If a release introduces a regression: re-pin to the previous tag, then docker compose up -d app. Schema rollbacks are not automatic — restore the MySQL/ClickHouse volumes from backup if a migration is involved.

Always back up before major upgrades. Snapshot the mysql_data and clickhouse_data volumes (or run the logical dump from the installation page) before bumping a major version.

Release notifications

Subscribe to the changelog. Major releases announce breaking changes at least one minor version ahead.