Regions
On Catalyst Cloud, you don't manage regions — Diagrid handles them. Skip to Projects unless your organization needs a region of its own: Dedicated Cloud, or BYOC in your own cloud.
A Region is a geographical/physical deployment unit within the Catalyst Data Plane, deployed on one Kubernetes cluster. Each Region hosts its own Dapr control plane and set of projects. Regions are the highest level of isolation in Catalyst — use them to deploy workloads closer to users, segregate environments by data residency, or run separate Regions for different business units.
Types of regions
The type of region you get follows from your deployment model — where the Catalyst data plane runs, and who operates it.
| Deployment model | Region runs in | Operated by | Setup required |
|---|---|---|---|
| Catalyst Cloud | Diagrid's cloud, multi-tenant | Diagrid | None — shared regions available to every organization |
| Dedicated Cloud | Diagrid's cloud, single-tenant | Diagrid | None — Diagrid provisions the region for you |
| BYOC — managed | Your cloud account | Diagrid | Grant Diagrid scoped access to your cloud account |
| BYOC — self-managed | Your Kubernetes cluster | You | Deploy and operate the Catalyst data plane yourself |
Diagrid-managed regions
On Catalyst Cloud, your projects run in shared, Diagrid-managed regions — there is nothing to create or operate. When you need single-tenant isolation and production sizing, Dedicated Cloud gives your organization its own region on Diagrid's cloud, provisioned and operated end to end by Diagrid.
BYOC regions
With bring your own cloud (BYOC), the Catalyst data plane runs inside your own cloud, so your application data never leaves your network. You choose how the region is operated:
- Managed — Diagrid provisions and operates the region in your cloud account through a cloud connection. No infrastructure for you to build or maintain.
- Self-managed — you run the Catalyst data plane on your own Kubernetes cluster and connect it to Diagrid Cloud. You own the infrastructure and its operations.
In Catalyst Enterprise Server deployments, the control plane runs in your infrastructure too, so regions are managed entirely through your own installation.
Create a region
How you create a region depends on your deployment model:
- Dedicated Cloud — a single CLI command or console action; Diagrid provisions everything.
- BYOC — managed — create a cloud connection granting Diagrid scoped access to your cloud account, then create the region through it.
- BYOC — self-managed — create the region in the Catalyst control plane and deploy the Catalyst data plane onto your own cluster, either end to end with
diagrid region deployor step by step with the Helm chart. Day-2 operations (token rotation, updates, deletion) are covered in Lifecycle management.
diagrid region deploy is available on the free Catalyst Cloud plan: running it starts a 30-day trial of Catalyst Enterprise, which lets you create and connect a self-managed region to your Diagrid Cloud organization. Contact us to continue using Catalyst Enterprise after the trial.
List regions
List every region in your organization:
diagrid region list
See diagrid region list for output formats.
Inspect a region
Get the details of a specific region — including its status, endpoints, and associated projects:
diagrid region get my-region
See diagrid region get.
Set the organization default region
Creating a project with diagrid project create without providing the --region flag provisions it in the Catalyst Cloud region by default. To set a custom default region for the organization use:
diagrid region use my-region
See diagrid region use.
Resource limits
Each region — whatever its type — has its own independent resource quotas. Projects, workloads, components, subscriptions,... count against the limits of the region they live in. Resources in different regions never affect each other's limits.
See Plans & Support for the full limits table.
What's next
- Catalyst hosting options — full comparison of deployment models.
- Dedicated Cloud — a single-tenant region provisioned and operated by Diagrid.
- BYOC — a region in your own cloud, operated by Diagrid or by you.
- Projects — create projects inside a region.