scale

The convox scale command views and adjusts the scale parameters of a service, including replica count, CPU allocation, and memory allocation. When called without flags, it displays the current scale configuration for all services in the app.

scale

Scale a service

Usage

    convox scale <service>

Examples

    $ convox scale web --count 3 --cpu 250 --memory 1024
    Scaling web...
    2026-01-15T14:54:50Z system/k8s/atom/app Status: Running => Pending
    2026-01-15T14:54:51Z system/k8s/web Scaled up replica set web-745f845dc to 3
    2026-01-15T14:54:51Z system/k8s/web-745f845dc Created pod: web-745f845dc-abc12
    2026-01-15T14:54:52Z system/k8s/atom/app Status: Pending => Updating
    2026-01-15T14:54:53Z system/k8s/web-745f845dc-abc12 Pulling image "registry.0a1b2c3d4e5f.convox.cloud/myapp:web.BABCDEFGHI"
    2026-01-15T14:54:56Z system/k8s/web-745f845dc-abc12 Successfully pulled image "registry.0a1b2c3d4e5f.convox.cloud/myapp:web.BABCDEFGHI"
    2026-01-15T14:54:56Z system/k8s/web-745f845dc-abc12 Created container main
    2026-01-15T14:54:56Z system/k8s/web-745f845dc-abc12 Started container main
    2026-01-15T14:55:01Z system/k8s/atom/app Status: Updating => Running
    OK

Flags

Flag Description
--count Number of desired replicas for the service
--cpu CPU allocation in millicores (e.g., 250 = 0.25 vCPU)
--memory Memory allocation in MB

See Also

  • Scaling for autoscaling configuration
  • Service for service scale attributes