Concurrency limits per platform
Concurrency limits are set per platform for each contract. Namespace automatically manages environments so that only active workloads (e.g. handling requests or with interactive workloads) consume concurrent capacity. There are no restrictions on the number of instances that can run in parallel as long as they fit within the concurrency limit. Each platform limit is independent and resources are not shared between platforms.
For example, in a Team plan for Linux, the concurrency limit is 64 vCPU, 128 GB RAM which can be used as:
- 4 instances with the shape of 16 vCPU, 32 GB RAM
- 8 instances of 8 vCPU, 16 GB RAM
- 32 instances of 2 vCPU, 4 GB RAM
- or any other combination with a total of 64 vCPU, 128 GB RAM.
Prioritizing and protecting concurrency limits
For larger organizations or multiple teams running different workflows, it might be important to prioritize workflows, profiles, or teams so that the concurrency limits are not starved. There are multiple solutions that allow you to handle this:Maximum number of concurrent instances per Runner Profile.
You can set the maximum number of concurrent instances per Runner Profile to restrict certain profiles that shouldn’t consume too many resources. This can be set up by our team - reach out to support@namespace.so to try it out.Multi-tenant account
A multi-tenant account connects multiple workspaces to a global account. In this case, concurrency limits can be set globally as well as per workspace. You can, for example, set a lower limit for workspace A and allocate the remaining overall account limit to workspace B. For example, if:- Your account has an overall limit of 1,600 vCPU and 3,200 GB RAM
- Workspace A has a limit of 640 vCPU, 1,280 GB RAM
- Workspace B doesn’t have a specific limit
API Error Details
When an instance creation request exceeds the workspace limits, the API returns an error with structured error details that your code can inspect programmatically:ResourceLimitsError: Returned when the request exceeds concurrency limits. Includes therequested,used, andlimitsresource counts (vCPU, memory, instance count). Thekindfield indicates whether the limit isCPU_MEMORY_LIMITorINSTANCE_COUNT_LIMIT.UsageLimitsError: Returned when the workspace has exhausted its usage quota for the billing period. Includes theusedandlimitsvalues forcompute_unit_minutesandcompute_wall_seconds.PlatformNotAllowedError: Returned when the requested platform (e.g.linux/arm64) is not enabled for the workspace. Includes therequested_platformand the list ofallowed_platforms.