Skip to main content
A capacity is a named container that tracks your compute allocation across one or more zones. Nodes attach to a capacity to receive compute time. Orders modify a capacity’s allocation schedule — buy orders add time, sell orders remove it.

​
Create a capacity

sf capacities create --zone richmond --name dev
A capacity must target at least one zone. You can target multiple zones so the system can place your nodes in whichever has availability. 
sf capacities create --zone richmond --zone marina --name multi-zone
Run sf zones ls to see available zones.

​
List capacities

sf capacities list

NAME                ZONE      COUNT  PERIOD  ID
dev                 richmond      -  -       cap_nuO4nVSM8O3NnsRE7udBe

​
View a capacity

sf capacities get dev

│ CAPACITY ID  cap_nuO4nVSM8O3NnsRE7udBe
│ NAME         dev
│ ZONES        richmond
└ CREATED      Feb 17, 5:23pm PDT

​
Allocation schedule

The allocation schedule shows how many nodes you have over time on this capacity. Each time a buy order fills, the schedule gains time. Each time a sell order fills, it loses time. Nodes attached to the capacity automatically start when there is allocated time and stop when the allocation runs out.

​
Update a capacity

Change the zones a capacity targets. 
sf capacities set dev --zone marina
Rename a capacity. 
sf capacities set dev --name production

​
Delete a capacity

sf capacities delete dev

​
API reference

See the Capacities API for programmatic access.