ScalixScalix Docs
Sign up

Rollbacks

Instantly revert to a previous service revision

Quick Rollback

Revert to the previous revision:

bash
scalix-cloud run rollback <service-id>

Rollback to Specific Revision

bash
scalix-cloud run rollback <service-id> --revision 2

Via the API:

bash
curl -X POST https://api.scalix.world/v1/services/{id}/rollback \
  -H "Authorization: Bearer $SCALIX_API_KEY"

The API rollback automatically reverts to the previous revision.

How It Works

Rollbacks are instant because previous container images are kept in the registry. The gateway routes traffic to the rolled-back revision's instances once they pass health checks.

  1. Old revision's image is pulled (already cached locally)
  2. New instances start with the old configuration
  3. Health checks pass
  4. Traffic shifts to the rolled-back revision
  5. Current revision's instances are drained and terminated

Automatic Rollback

If a new deployment fails health checks, Scalix Run automatically rolls back to the last healthy revision.