Skip to content

Upgrade

This page covers the upgrade and rollback procedures for a self-hosted XTM One instance. Filigran SaaS and Filigran Dedicated instances are upgraded by Filigran.

Procedure

  1. Read the release notes.
  2. Apply the update based on your deployment option:

Pre-built images (Option B):

docker compose pull
docker compose up -d

Source-based (Option A):

git fetch --tags
git checkout <new-version-tag>
docker compose build --pull
docker compose up -d

Migrations run automatically on startup. Wait for /api/health/ready to return 200 before verifying.

Image tags follow the format <major>.<YYMMDD>.<patch> and are listed on Docker Hub.

Rollback

Warning

Migrations run automatically on startup and may alter the database schema. Once a migration has run, the previous application version may not work against the new schema. Rollback requires restoring the database and object storage from the same pre-upgrade recovery point.

  1. docker compose down
  2. Restore the database from the pre-upgrade backup.
  3. Restore MinIO/S3 to the same recovery point.
  4. Revert image tags to the previous version.
  5. docker compose up -d