Regions
On Catalyst Cloud, you don't manage regions — Diagrid handles them. Skip to Projects unless you're setting up Catalyst Enterprise Self-Hosted.
A region is an isolated instance of the Catalyst data plane. Each region runs on its own Kubernetes cluster and 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 clusters for different business units.
How regions work across hosting options
| Hosting option | Who operates the region | How regions are created |
|---|---|---|
| Catalyst Cloud | Diagrid | Regions are managed by Diagrid and available to all Cloud customers. |
| Catalyst Enterprise — Dedicated | Diagrid | Diagrid provisions a dedicated region (cluster) for your organization. |
| Catalyst Enterprise — Self-Hosted | Customer | You create a region in the control plane and deploy the data plane into your own Kubernetes cluster. |
| Catalyst Enterprise — Air-Gapped | Customer | Region is deployed fully offline with no external connectivity to the Diagrid control plane. |
On Catalyst Cloud you typically don't need to manage regions directly — projects are created in a Diagrid-managed region. On Catalyst Enterprise Self-Hosted, creating and deploying a region is the first step to use Catalyst in your own infrastructure.
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.
Deploying a self-hosted region
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-hosted region to your Diagrid Cloud organization. Contact us to continue using Catalyst Enterprise after the trial.
The full workflow for creating and deploying a self-hosted region — capacity planning, infrastructure requirements, Helm chart configuration, and AWS/Azure guidance — lives in the Catalyst Enterprise Self-Hosted installation guide. Day-2 operations for self-hosted regions (token rotation, updates, deletion) are covered in Upgrades & Operations.
What's next
- Catalyst hosting options — full comparison of deployment models.
- Projects — create projects inside a region.
- Installation guide — deploy a self-hosted region end-to-end.