Choose a size for a Cloud box

Size is vCPU, memory, and disk. Pick the smallest preset that runs your workload comfortably — it is what you pay for by the hour.

​

Prerequisites

• An API key from the console, exported as BOXLITE_API_KEY. See API keys.
• pip install boxlite, and the REST URL exported as BOXLITE_REST_URL. See Quickstart.

​

Choose a size

The console offers three presets and a custom option: Pick Small for shell work and short scripts, Medium for test suites and dependency installs, Large for builds and anything that keeps several processes hot.

​

Per-organization ceilings

Custom is bounded. Your organization has one ceiling per box: The console shows these under Box limits on the Billing page, with the reason:

Limits mitigate misuse and keep box and compute capacity fairly available across all users.

Read your current ceilings in Managing billing. Split a workload that wants more than one box can hold across several boxes rather than trying to raise a single box past the ceiling.

​

The SDK’s sizing fields

BoxOptions accepts cpus, memory_mib, and disk_size_gb. Their types, units, and general behavior live in Compute resources — the console sizes above are the verified way to size a Cloud box, so set the size in the console when you want a specific shape. The disk field is named disk_size_gb. disk_gib is a common guess and fails at construction with a no-such-field error.

​

Troubleshooting

​

Next steps