Updating
Update Stasis to a new version
Updating
This page explains how to update Stasis to a new version.
Before You Update
- Back up your data — see Backup
- Check the release notes — look for breaking changes
- Test in a staging environment if possible
Updating with Docker Compose
1. Pull the latest changes
cd stasis
git pull origin main2. Rebuild the images
docker compose build3. Restart the services
docker compose up -d4. Verify
# Check all services are running
docker compose ps
# Check the health endpoint
curl http://localhost/api/v1/health
# Check the web interface
curl -o /dev/null -s -w "%{http_code}" http://localhostDatabase Migrations
Stasis runs database migrations automatically on startup. You don't need to run them manually.
If a migration fails, check the API logs:
docker compose logs api | grep -i migrationRolling Back
If something goes wrong after an update:
1. Stop the services
docker compose down2. Restore from backup
See Backup for restore instructions.
3. Check out the previous version
git checkout v1.x.x # replace with the version you want4. Rebuild and start
docker compose build
docker compose up -dUpdating the CI Runner
The CI runner is updated separately:
cd stasis-ci
git pull origin main
docker compose build
docker compose up -dChecking Your Version
curl http://localhost/api/v1/health | jq .version