---
title: "Limits and scaling"
description: "How many agents and task queues a tenant may have, what a large plugin and a tenant of many small plugins cost, what 10,000 agents in one tenant measured, and what a fleet of nodes under load measured."
canonical_url: "https://docs.oz0.ai/concepts/limits-and-scaling"
---
# Limits and scaling

> How many agents and task queues a tenant may have, what a large plugin and a tenant of many small plugins cost, what 10,000 agents in one tenant measured, and what a fleet of nodes under load measured.

For: cluster operators and plugin authors.

Plan capacity from the tenant limits, the queues your plugins need and the measurements for your deployment. Agent counts alone do not describe the work a node or Temporal backend must handle.

A tenant's agents run on Temporal task queues, and every queue a node polls is registered in the tenant's Worker Deployment version when a new runtime version first polls it ([Temporal](https://docs.oz0.ai/concepts/temporal)). That registration is what limits how many queues a tenant may have, so Orchestrator Zero keeps the queues few: a plugin's agents and flows share one queue for each set of node labels they require ([routing](https://docs.oz0.ai/concepts/routing)).

Check [Compatibility](https://docs.oz0.ai/reference/compatibility) for platform requirements and integration maturity, and [Known issues](https://docs.oz0.ai/reference/known-issues) for operational problems and workarounds.

## Related tasks and reference

- [Tenant and queue limits](https://docs.oz0.ai/concepts/limits-and-scaling/limits)
- [Capacity measurements](https://docs.oz0.ai/concepts/limits-and-scaling/measurements)

<legacy-sections>

### 10,000 agents in one tenant

[Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/limits#_10000-agents-in-one-tenant).

<span id="a-fleet-under-load">

a fleet under load

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/measurements#a-fleet-under-load).

<span id="a-tenant-of-many-small-plugins">

a tenant of many small plugins

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/measurements#a-tenant-of-many-small-plugins).

<span id="how-many-queues-a-plugin-uses">

how many queues a plugin uses

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/limits#how-many-queues-a-plugin-uses).

<span id="more-than-the-limits">

more than the limits

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/limits#more-than-the-limits).

<span id="near-the-limit">

near the limit

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/measurements#near-the-limit).

<span id="other-temporal-backends">

other temporal backends

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/measurements#other-temporal-backends).

<span id="run-it-yourself">

run it yourself

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/measurements#run-it-yourself).

<span id="the-limits">

the limits

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/limits#the-limits).

<span id="what-a-pool-means-for-capacity">

what a pool means for capacity

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/limits#what-a-pool-means-for-capacity).

<span id="what-limits-what">

what limits what

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/measurements#what-limits-what).

<span id="what-we-measured">

what we measured

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/measurements#what-we-measured).

<span id="when-a-plugin-update-adds-an-agent">

when a plugin update adds an agent

</span>

: [Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/limits#when-a-plugin-update-adds-an-agent).

### 10,000 agents in one tenant

[Read the section](https://docs.oz0.ai/concepts/limits-and-scaling/limits#_10000-agents-in-one-tenant).

</legacy-sections>


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.