Compute

Run containers and services on Scalix Cloud

Overview

Run your containers and long-running services on Scalix Run — deploy a container image, get autoscaling, health checks, revisions, and zero-downtime rollouts. Run is the supported path for executing container workloads today.

The /v1/compute/deployments endpoints described below manage deployment records and their scaling configuration. For workloads you want to actually execute, deploy them as a Run service.

Deploy a service (Scalix Run)

Deployments build from a container image in the registry (push with scalix-cloud builds, or bring your own image):

scalix-cloud run deploy \
  --name api-server \
  --image registry.scalix.world/my-org/api:v1.2 \
  --port 8080 \
  --min-instances 1 \
  --max-instances 10

See Scalix Run for the full deploy, scale, and rollback workflow.

Compute deployment records

Create a deployment record via the API. The accepted fields are name, image, min_instances, max_instances, and env:

curl -X POST https://api.scalix.world/v1/compute/deployments \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "api-server",
    "image": "registry.scalix.world/my-org/api:v1.2",
    "min_instances": 1,
    "max_instances": 3,
    "env": {
      "DATABASE_URL": "postgres://...",
      "NODE_ENV": "production"
    }
  }'

Update the scaling configuration for a deployment by its id:

curl -X POST https://api.scalix.world/v1/compute/deployments/$DEPLOYMENT_ID/scale \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "min_instances": 1,
    "max_instances": 10
  }'

Supported Runtimes

Images are built from your repository, with the runtime auto-detected:

Rollouts and rollback (Scalix Run)

# View services
scalix-cloud run list
 
# Roll back to the previous revision
scalix-cloud run rollback <service-id>