Upgrades

Move to new releases safely, and roll back if something goes wrong.

Updated August 28, 2026

Upgrades are designed to be boring: pull newer images, recreate the containers, keep the data volumes. Your projects, knowledge bases, and license are preserved across upgrades.

Standard upgrade

  1. Take a fresh backup (see Backup & restore).
  2. Re-run your install command — it detects the existing install and upgrades it — or pull the latest images and recreate containers with Docker Compose.
  3. Verify with the health check and confirm the new version at /api/version.

Database migrations

Schema migrations run automatically on startup and are designed to be forward-safe. The pre-upgrade backup is your safety net — take it every time.

Rolling back

  1. Stop the application services.
  2. Start the previous image version.
  3. If the newer release migrated the schema, restore the pre-upgrade database backup as well.

Running CrestBid for a team and need zero-downtime upgrades or high-availability patterns? Those are documented for Enterprise deployments — contact sales.