Skip to content

Usage & Quotas

The usage page shows how much of your organization capacity is currently in use. Use it before scaling workloads, adding replicas, creating storage, or opening more editor and runner sessions.

Opening Usage

Go to Settings > Organization > Usage.

The page summarizes resource usage across the organization. Depending on enabled features, it can show deployment capacity, storage consumption, editor capacity, runner capacity, and API activity.

Quota Categories

CategoryWhat it protects
DeploymentsReplicas, CPU, memory, persistent storage, and per-container limits.
EditorsBrowser editor sessions, workspace storage, editor CPU, and editor memory.
RunnersConcurrent CI jobs and runner resource requests.
StoragePostgreSQL and S3-compatible object storage allocation.
MembersSeats and organization membership limits.

Deployment Capacity

Deployment quotas are checked when you create or update a deployment. The platform validates:

  • Replica count.
  • CPU request and limit.
  • Memory request and limit.
  • Persistent storage count and size.
  • Per-container maximums.

If a request exceeds quota, the operation is rejected before runtime resources are created.

Editor and Runner Capacity

Editor and runner capacity are separate from deployment capacity.

  • Editors consume workspace/session quota.
  • Runners consume CI capacity.
  • Deployments consume tenant runtime quota.

If an editor cannot start, check editor quotas. If a pipeline is queued or cannot allocate a worker, check runner quotas.

Storage Usage

Storage usage tracks provisioned PostgreSQL and object storage resources. Storage pages also show app-specific databases and buckets.

For storage workflows, see Provisioning Storage.

Troubleshooting

SymptomWhat to check
Deployment creation is rejectedCompare requested replicas, CPU, memory, and storage against current quota.
Editor cannot startCheck active editor sessions and workspace storage usage.
CI run is waitingCheck runner capacity and whether another run is occupying the runner pool.
Storage cannot be provisionedCheck storage quotas and whether the app already has the requested resource.
Usage looks staleRefresh the page and check Support & Status if the value still does not update.

Next Steps

NextEpoch Cloud Documentation