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
- Read the release notes for the version you're upgrading to — especially any breaking changes or manual migration steps.
- Take a backup before every upgrade. See Backup & Restore.
Rollback
If something goes wrong after an upgrade:
- Stop the current container
- Start the previous image version (you'll need the old image tag)
- Restore your database from the pre-upgrade backup