> ## Documentation Index
> Fetch the complete documentation index at: https://docs.provisionr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tenant Infrastructure Isolation

> Every workspace runs in isolated compute, database, secrets, and encryption keys across Shared, Dedicated, or Sovereign tiers with regional data residency control.

Now that you know how people and services sign in to your workspace, this page looks at the infrastructure that the workspace runs on. Every workspace has its own compute, database, secrets, and encryption keys, and your plan decides where that infrastructure lives:

* Baseline and Growth workspaces run on Google Cloud Platform (GCP), in one of our managed regions
* Scale workspaces run in a Provisionr-managed AWS account, in the United States or the European Union
* Sovereign workspaces run in your own AWS account, so you can choose any region around the world

Wherever you deploy, your data stays in that region, including backups, which use a secondary region in the same jurisdiction where possible. This gives you direct control over data residency for compliance with regional regulations.

***

## Google Cloud Platform (GCP)

Workspaces on the [Baseline](https://docs.provisionr.io/plans/evaluator.md) and [Growth](https://docs.provisionr.io/plans/essentials.md) plans run on Google Cloud Platform (GCP), using Cloud Run for compute and Postgres on Cloud SQL for the database. Each region has an independent control plane for data residency and data sovereignty compliance, and each workspace has its own isolated compute, database, secrets management, and encryption keys.

We selected GCP for its global presence, its strong security controls, and its ability to isolate the compute and data of each tenant, along with scale-to-zero compute that allows us to scale cost-efficiently.

### GCP Regions

You can deploy your workspace in any of our eight GCP regions around the world. Each region has its own independent control plane and infrastructure, which meets data residency and sovereignty requirements and allows us to optimize latency and availability for customers around the world.

| Region | GCP Region | Location |
| - | - | - |
| United States | `gcp/us-central1` | Iowa |
| European Union | `gcp/europe-west1` | Belgium |
| Canada | `gcp/northamerica-northeast1` | Montreal |
| Australia | `gcp/australia-southeast1` | Sydney |
| Mexico | `gcp/northamerica-south1` | Mexico City |
| Japan | `gcp/asia-northeast1` | Tokyo |
| Brazil | `gcp/southamerica-east1` | São Paulo |
| India | `gcp/asia-south1` | Mumbai |

### GCP Data Isolation

Each region's workspaces share a GCP project, but every workspace on this shared infrastructure gets its own resources, as the diagram shows.

![GCP Isolation Diagram](https://mintcdn.com/provisionr/5zHK7_yFbQpST1yq/images/diagrams/concepts/workspace/infra-gcp-isolation.svg?fit=max\&auto=format\&n=5zHK7_yFbQpST1yq\&q=85\&s=877eb833e0fc8af25763744036c2b91a)

Each tenant runs in its own isolated environment, with isolated compute, database, and secrets. Each service account is granted roles only for its specific tenant's resources.

| Resource | What each workspace receives |
| - | - |
| Cloud Run service | A dedicated container for each workspace, with its own process space, memory, and environment variables. No workspace shares compute with another workspace. |
| Cloud SQL PostgreSQL database | A separate database for each workspace on a shared Cloud SQL instance. One workspace can't query another workspace's database. |
| Encryption key | A dedicated encryption key for each workspace, stored in GCP Secret Manager and injected at runtime. Each workspace's encrypted data can only be decrypted with its own key. |
| Subdomain | A dedicated subdomain for each workspace, `{tenant id}.provisionr.app`, routed at the edge by a Cloudflare Worker. |
| Regional data residency and data sovereignty | The control plane and workspace data stay within your selected region. Backup and disaster recovery use a second region in the same country or compliance framework geography. |
| Release channel and updates | Each workspace uses tagged version images from the Provisionr container registry, and each workspace administrator can choose their preferred upgrade schedule. Updates are mandatory, but you can enable or disable the feature flags for major changes at your discretion. |

The word "shared" refers to the GCP project for that region's workspaces, and to the Cloud SQL instances (compute) that are shared across tenants. Each tenant's workload is fully isolated, with its own app container, Postgres database, secret management, and encryption key. All of a workspace's services run with a GCP service account that's dedicated to that tenant, which provides Workload Identity isolation for each workspace.

### Cloudflare Edge Routing

All tenant traffic passes through Cloudflare before it reaches Cloud Run, and Cloudflare handles DDoS mitigation and TLS termination. Along the way, the Cloudflare Worker handles these tasks:

* Extracting the subdomain from each request
* Validating the JWT session at the edge
* Looking up the tenant's Cloud Run service URL in Workers KV
* Handling cold starts with a loading page

### Cloud Run Serverless Compute

Each tenant's Cloud Run service runs in a gVisor sandbox, which provides container-level isolation. Each tenant's service also scales independently, so one tenant under heavy load doesn't affect the capacity available to another tenant.

Because a service scales to zero when it's idle, the first request after a quiet period can arrive before an instance is running. That's the cold start that the Cloudflare Worker covers with its loading page.

### Database Connections

Each GCP project contains one or more Cloud SQL PostgreSQL instances, and every tenant has its own database within an instance.

Cloud Run services connect to their databases through the Cloud SQL Auth Proxy sidecar, which is built into Cloud Run's native Cloud SQL integration, and each tenant's service connects only to its own database. The Cloud SQL Auth Proxy provides secure, passwordless authentication with Workload Identity service accounts and encrypted connections to the database, which ensures that one tenant can't access another tenant's database.

### GCP Secret Management

Each tenant's application encryption key (`APP_KEY`) and other secrets are stored in GCP Secret Manager, within the region's GCP project. The secrets are handled in the same way for every tenant:

* Each tenant has one secret, with one active version
* The secret is mounted into the tenant's Cloud Run service as an environment variable at deploy time
* An IAM policy restricts access to the tenant's own Cloud Run service identity
* The secret isn't accessible to other tenants or to other services within the project

## Managed AWS Account

Workspaces on the [Scale](https://docs.provisionr.io/plans/enterprise.md) plan run on Amazon Web Services (AWS), using ECS Fargate for compute and RDS for the PostgreSQL database. Scale workspaces are managed by Provisionr's internal orchestration system, which provides isolation and multi-tenancy controls similar to those of the GCP architecture.

Each Scale workspace is provisioned in an AWS account that's shared with other tenants, but each workspace has its own dedicated ECS compute, RDS database server, secrets management, and encryption keys. As with GCP, each region has an independent control plane for data residency and data sovereignty compliance.

### Managed AWS Regions

You can deploy your workspace in a Provisionr-managed AWS account in the United States or the European Union.

| Region | AWS Region | Location |
| - | - | - |
| United States | `aws/us-east-2` | Ohio |
| European Union | `aws/eu-central-1` | Frankfurt |

## Self-Hosted AWS Account

The [Sovereign](https://docs.provisionr.io/plans/sovereign.md) plan is available on the AWS Marketplace, and you deploy it in your own AWS account with a CloudFormation template, which gives you complete control over the infrastructure, data, and security. The Provisionr team doesn't have access to your workspace, and we provide updates through Amazon Elastic Container Registry (ECR). The workload that you deploy has an architecture similar to the Scale plan, with dedicated ECS Fargate compute, RDS database server, secrets management, and encryption keys.

### Self-Hosted AWS Regions

You can deploy a Sovereign workspace in any of the AWS regions in this table. In a few regions, only the availability zones listed beside the region identifier are supported.

| Region Name | AWS Identifier |
| - | - |
| US East (Ohio) | `us-east-2` |
| US East (N. Virginia) | `us-east-1` |
| US West (N. California) | `us-west-1` (usw1-az1 & usw1-az3 only) |
| US West (Oregon) | `us-west-2` |
| Canada (Central) | `ca-central-1` |
| Canada West (Calgary) | `ca-west-1` |
| Mexico (Central) | `mx-central-1` |
| Africa (Cape Town) | `af-south-1` |
| Asia Pacific (Hong Kong) | `ap-east-1` |
| Asia Pacific (Mumbai) | `ap-south-1` |
| Asia Pacific (Tokyo) | `ap-northeast-1` (apne1-az1, apne1-az2, & apne1-az4 only) |
| Asia Pacific (Seoul) | `ap-northeast-2` |
| Asia Pacific (Osaka) | `ap-northeast-3` |
| Asia Pacific (Hyderabad) | `ap-south-2` |
| Asia Pacific (Singapore) | `ap-southeast-1` |
| Asia Pacific (Sydney) | `ap-southeast-2` |
| Asia Pacific (Thailand) | `ap-southeast-7` |
| Asia Pacific (Jakarta) | `ap-southeast-3` |
| Asia Pacific (Melbourne) | `ap-southeast-4` |
| Asia Pacific (Malaysia) | `ap-southeast-5` |
| China (Beijing) | `cn-north-1` (cnn1-az1 & cnn1-az2 only) |
| China (Ningxia) | `cn-northwest-1` |
| Europe (Frankfurt) | `eu-central-1` |
| Europe (Zurich) | `eu-central-2` |
| Europe (Ireland) | `eu-west-1` |
| Europe (London) | `eu-west-2` |
| Europe (Paris) | `eu-west-3` |
| Europe (Milan) | `eu-south-1` |
| Europe (Spain) | `eu-south-2` |
| Europe (Stockholm) | `eu-north-1` |
| South America (São Paulo) | `sa-east-1` |
| Israel (Tel Aviv) | `il-central-1` |
| Middle East (Bahrain) | `me-south-1` |
| Middle East (UAE) | `me-central-1` |
| AWS GovCloud (US-East) | `us-gov-east-1` |
| AWS GovCloud (US-West) | `us-gov-west-1` |

***

Within each of these environments, every record that Provisionr stores has an ID that starts with a short prefix for its type, and the next page explains how those prefixes are built.

[Continue reading: Naming Conventions →](https://docs.provisionr.io/concepts/workspace/nomenclature.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.