Quota Limits - Documentation

Agent Sandbox applies quota limits based on your account tier. Quotas define the resources and capabilities available to each tier. If you need higher limits, please contact our support team.

Account Tiers

Account Tier	Description
Free	The default tier for new users.
Paid	Available after adding account balance or enabling a credit line.
Enterprise	Designed for enterprise customers that need custom limits and dedicated support.

Default Quotas

Limit	Free	Paid	Enterprise
Concurrent sandboxes	5	100	500 by default, adjustable
Maximum session duration	1 hour	3 hours	4 hours by default, adjustable
Maximum vCPU	2 vCPU	8 vCPU	8 vCPU by default, adjustable
Maximum memory	4 GiB	8 GiB	8 GiB by default, adjustable
Local disk space	20 GB	20 GB	20 GB by default, adjustable
Memory increment	512 MiB	512 MiB	512 MiB
Memory per vCPU	0.5-4 GiB	0.5-4 GiB	0.5-4 GiB

Configuration Rules

When configuring CPU and memory, your configuration must meet the following requirements:

vCPU must not exceed the maximum vCPU limit for your account tier.
Memory must not exceed the maximum memory limit for your account tier.
vCPU must be configured as an integer value, such as 1, 2, 4, or 8 vCPU.
Memory must be configured in 512 MiB increments.
Memory must be within the allowed range of 0.5-4 GiB per vCPU.

For example:

1 vCPU supports 512 MiB to 4 GiB of memory.
2 vCPU supports 1 GiB to 8 GiB of memory.
4 vCPU can support up to 16 GiB of memory based on the memory-per-vCPU range, but the actual available memory is still limited by the maximum memory quota of your account tier.

The final available configuration is determined by both your account tier limits and the allowed memory-per-vCPU range.

Check Current Quota Usage

Use the quota API to check the quota limits available to your account and the resources currently in use. This is useful before launching a large batch of sandboxes or when troubleshooting quota-related launch failures.

Check quota usage using the SDKs

import { Sandbox } from 'novita-sandbox'

const quota = await Sandbox.getQuota()

console.log('Quota limit:', quota.limit)
console.log('Current usage:', quota.usage)

// Example shape:
// {
//   limit: {
//     concurrentInstances: 100,
//     concurrentVcpu: 200,
//     concurrentRamMb: 409600,
//     maxLengthHours: 4,
//     diskMb: 20480,
//     maxVcpu: 8,
//     maxRamMb: 8192
//   },
//   usage: {
//     concurrentInstances: 12,
//     concurrentVcpu: 24,
//     concurrentRamMb: 49152
//   }
// }

from novita_sandbox.core import Sandbox

quota = Sandbox.get_quota()

print('Quota limit:', quota.limit)
print('Current usage:', quota.usage)

# Example shape:
# {
#     "limit": {
#         "concurrentInstances": 100,
#         "concurrentVcpu": 200,
#         "concurrentRamMb": 409600,
#         "maxLengthHours": 4,
#         "diskMb": 20480,
#         "maxVcpu": 8,
#         "maxRamMb": 8192,
#     },
#     "usage": {
#         "concurrentInstances": 12,
#         "concurrentVcpu": 24,
#         "concurrentRamMb": 49152,
#     },
# }

Quota response fields

The quota response includes limit and usage objects.

Field	Description
`limit.concurrentInstances`	Maximum number of sandboxes that can run concurrently.
`limit.concurrentVcpu`	Maximum total vCPU cores that can be used concurrently.
`limit.concurrentRamMb`	Maximum total RAM that can be used concurrently, in MB.
`limit.maxLengthHours`	Maximum lifetime for a single sandbox, in hours.
`limit.diskMb`	Available runtime storage for a single sandbox, in MB.
`limit.maxVcpu`	Maximum vCPU cores for a single sandbox. Applies after the template is built.
`limit.maxRamMb`	Maximum memory for a single sandbox, in MB. Applies after the template is built.
`usage.concurrentInstances`	Current number of running sandboxes.
`usage.concurrentVcpu`	Current total vCPU cores in use.
`usage.concurrentRamMb`	Current total RAM in use, in MB.

Quota usage is intended for capacity planning and troubleshooting. Usage data may have a short delay, depending on the backend resource reporting path.

Notes

If your resource configuration exceeds the quota for your account tier, the request will fail.
If a region has no available capacity, sandbox creation may fail with a quota or rate-limit related error even when your account-level quota has not been fully used.
Choose CPU and memory based on your workload requirements to avoid out-of-memory errors or unnecessary resource usage.
Enterprise quotas can be customized based on your requirements. To request a quota increase, please contact our support team.

​Account Tiers

​Default Quotas

​Configuration Rules

​Check Current Quota Usage

​Check quota usage using the SDKs

​Quota response fields

​Notes

Account Tiers

Default Quotas

Configuration Rules

Check Current Quota Usage

Check quota usage using the SDKs

Quota response fields

Notes