Upgrades

How to upgrade SculptOps safely.

Before upgrading

Take a database backup and make sure your deployment secrets are available. See the Backup & Restore guide before upgrading production instances.

Docker Compose upgrade

If you deploy the prebuilt image, pull the new version and recreate the containers:

bash
docker compose pull
docker compose up -d

Database migrations run automatically on startup. If you build from source instead, use git pull followed by docker compose up -d --build.

Watch the application logs after the upgrade:

bash
docker compose logs app --tail=100

Rollback

If an upgrade fails, restore the previous source revision and the matching database backup.

Warning
Rolling back after database changes is safest when you restore the database backup taken immediately before the upgrade.