Rollbacks

Roll back a Scalix Run service to a previous revision instantly via CLI or API, with automatic rollback when a new deployment fails health checks.

Quick Rollback

Revert to the previous revision:

scalix-cloud run rollback <service-id>

Rollback to Specific Revision

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

Via the API:

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.