Upgrading

GitBlixt upgrades are designed to be safe and fast. Database migrations run automatically on startup.

Standard Upgrade

    docker compose pull
docker compose up -d

Compose pulls the latest image and recreates only the gitblixt container. The database container stays running. Migrations run automatically on startup.

Upgrading to a Specific Version

Set the version in your .env or override the image directly:

GITBLIXT_IMAGE=gitblixt/gitblixt:1.2.0 docker compose up -d

Before Upgrading

  1. Read the release notes for the version you're upgrading to — especially any breaking changes or manual migration steps.
  2. Take a backup before every upgrade. See Backup & Restore.

Rollback

If something goes wrong after an upgrade:

  1. Stop the current container
  2. Start the previous image version (you'll need the old image tag)
  3. Restore your database from the pre-upgrade backup