Up to 2,000 Users

In the 2,000 users architecture, there is a moderate increase in traffic, suggesting a growing user base or expanding operations. This setup is well-suited for mid-sized companies experiencing growth or for universities seeking to accommodate their expanding user populations.

Users can be evenly distributed between 2 regions or be attached to different clusters.

Target load: API: up to 300 RPS

High Availability: The mode is enabled; multiple replicas provide higher deployment reliability under load.

Hardware recommendations

Coderd nodes

Provisioner nodes

Footnotes:

• An external provisioner is deployed as Kubernetes pod.
• It is not recommended to run provisioner daemons on coderd nodes.
• Consider separating provisioners into different namespaces in favor of zero-trust or multi-cloud deployments.

Workspace nodes

Footnotes:

• Assumed that a workspace user needs 2 GB memory to perform
• Maximum number of Kubernetes workspace pods per node: 256
• Nodes can be distributed in 2 regions, not necessarily evenly split, depending on developer team sizes

Database nodes

Footnotes:

• Consider adding more replicas if the workspace activity is higher than 500 workspace builds per day or to achieve higher RPS.

Footnotes for AWS instance types:

• For production deployments, we recommend using non-burstable instance types, such as m5 or c5, instead of burstable instances, such as t3. Burstable instances can experience significant performance degradation once CPU credits are exhausted, leading to poor user experience under sustained load.