In one paragraph: every account has limits on the cloud resources it can run: vCPU, memory, servers, volumes, disk, public IPs and more. You can see your limits and live usage at any time, check whether a cluster fits before you order it, and ask for a higher limit. Every request opens a support ticket and a person from our team decides, and the new limit applies once it is approved.
See your limits
In the console: open Cloud, then Limits.
In the CLI:
rarecloud limits
Through the API: GET /v1/limits (scope services:read). Each entry in resources has resource, used, limit, state and ratio:
state | Meaning |
|---|---|
ok | Under 80% of the limit |
warn | From 80% |
danger | From 95% |
unknown | The usage could not be read just now, marked unavailable: true. It does not mean nothing is used |
A limit of -1 means unlimited. nearingLimit is true when any resource is at warn or danger.
The same answer carries registry (the Container Registry's storage and repository figures) and sandboxes (running AI Sandboxes against your limit). Each is null when it does not apply or could not be read just now.
The MCP server reads this with get_quota_limits, and Terraform with the rarecloud_limits data source.
Will a Kubernetes cluster fit?
Ask before you order. Nothing is created or reserved.
rarecloud limits estimate --pool type=g-2vcpu-8gb,min=2,max=4
Through the API, it is POST /v1/limits/estimate (scope services:read) with up to 5 pools:
curl -s https://api.rarecloud.io/v1/limits/estimate \
-H "Authorization: Bearer $RARECLOUD_TOKEN" \
-H "Content-Type: application/json" \
-d '{"pools":[{"machineType":"g-2vcpu-8gb","minimum":2,"maximum":4}]}'
minimum and maximum are 1 to 16. The answer tells you:
fits: whether the pools' minimums fit in what is left. If they do not, the cluster cannot start.shortfall: what is missing, keyed the same way as a limit request, so you can send it as is.- For each pool,
reachableout ofconfigurednodes, and the resource that islimitingit. A pool whose minimum fits but whose maximum does not still deploys and autoscales, up toreachable. available: falsemeans we could not work it out. That is unknown, not "does not fit".
The MCP server has this as estimate_limits.
Ask for a higher limit
In the console: open Cloud, then Limits, and use Request limit increase.
In the CLI:
rarecloud limits request --set cores=64 --set ram=262144 \
--reason "Scaling the production cluster for a launch" --yes
rarecloud limits requests
Through the API: POST /v1/limits/requests (scope services:write):
curl -s https://api.rarecloud.io/v1/limits/requests \
-H "Authorization: Bearer $RARECLOUD_TOKEN" \
-H "Content-Type: application/json" \
-d '{"requested":{"cores":64},"reason":"Scaling the production cluster for a launch"}'
The MCP server has this as request_quota_increase, which needs your confirmation.
reason is 10 to 2000 characters. Tell us what you are building: it is what the person reviewing the request reads.
requested key | What it raises | Value |
|---|---|---|
cores | vCPU | A positive number, or -1 for unlimited |
ram | Memory, in MB | A positive number, or -1 |
instances | Servers | A positive number, or -1 |
volumes | Volumes | A positive number, or -1 |
gigabytes | Volume storage, in GB | A positive number, or -1 |
floatingip | Public IPs | A positive number, or -1 |
object_storage_tb | Object Storage, in whole TB | 1 to 1000 |
sandboxes | AI Sandboxes running at once | 1 to 200 |
What happens next
- The request is recorded as
pendingand opens a support ticket. The request carries the ticket number, and you can follow it under Support. - A person from our team reviews it. The decision arrives as a reply on the ticket and by email.
- If it is approved, the new limit applies and the request shows
approved, with what was granted ingranted. Otherwise it showsdenied.
You can have one pending request at a time. Sending a new one replaces it and posts the new numbers on the same ticket.
GET /v1/limits/requests (scope services:read), rarecloud limits requests and the MCP tool list_quota_requests list your requests. Requests from before every request went to review can also show auto_approved.
Troubleshooting
| What you see | What it means |
|---|---|
| An order is refused for a limit | Check your usage with rarecloud limits, then free something up or ask for more. |
400 INVALID_PARAM on a request | A value is out of range, or reason is too short. The message names the field. |
403 ACCOUNT_ORDERING_BLOCKED | New orders are paused on this account, and limit requests with them. Contact support. |
state is unknown | The usage could not be read just now. Read it again shortly. |