Upgrading

Upgrade script since v2.0.0

Database migrations run automatically when the backend starts.

Standard upgrade

./scripts/upgrade.sh                # pull images for the latest release
./scripts/upgrade.sh 2.4.3          # upgrade to v2.4.3
./scripts/upgrade.sh --local-build  # rebuild from source instead of pulling
./scripts/upgrade.sh 2.4.3 --local-build

By default the script pulls the published images from registry.gitlab.com for the requested version (or the latest release). With --local-build it rebuilds the containers from source.

Rollback

# Restore the backup and restart the previous image
cat servasec_backup_20260702.sql | docker compose exec -T db psql -U servasec servasec

Adding a migration (developers)

make migrate-create NAME=describe_your_change

Edit the generated file in backend/migrations/, rebuild, restart. The new migration runs automatically on next startup. See backend/migrations/MIGRATIONS.md for the version-to-app mapping.