Regions
Selecting a region during database and branch creation.
Overview
PlanetScale currently offers database deployment in multiple regions. Select the region closest to your application servers to reduce latency between your database and application. Deploy development branches in the region closest to your own location to reduce latency when working with the branch.
You may also add read-only regions to your production database. See our Read-only regions documentation for more information.
A number of resources exist to help find which region has the lowest latency from your location – such as CloudPing.
Available regions
Currently, the following regions are supported, with their respective PlanetScale slugs:
- AWS us-east-1 (Northern Virginia) -
us-east
- AWS us-west-2 (Oregon) -
us-west
- AWS eu-west-1 (Dublin) -
eu-west
- AWS ap-south-1 (Mumbai) -
ap-south
- AWS ap-southeast-1 (Singapore) -
ap-southeast
- AWS ap-northeast-1 (Tokyo) -
ap-northeast
- AWS eu-central-1 (Frankfurt) -
eu-central
- AWS ap-southeast-2 (Sydney) -
aws-ap-southeast-2
- AWS sa-east-1 (Sao Paulo) -
aws-sa-east-1
Selecting the database region
PlanetScale allows you to select the region for the main branch of your database during database creation. By default, all database branches created within this database will also be created in this region.
Select your database region.
You can also select the region while creating a database via the CLI by using
the --region
flag with the region's slug.
If you do not select a region during database creation using the CLI, it will be set to AWS us-east-1.
Here's an example command for creating a database with a different region:
Selecting the branch region
PlanetScale allows you to select a region for development branches during creation as well. By default, it is set to the same region as its database.
Select your branch region.
You can also select the region while creating a branch via the CLI by using the
--region
flag with the region's slug.
Here's an example command for creating a branch with a different region:
Restricting the branch regions
Organization Administrators can restrict branches to only being created in the same region as the one selected during database creation. To enable this setting, check the Restrict region setting in the settings page for the database: app.planetscale.com/<org>/<database>/settings
.
Restrict your branches to one region.
Need help?
Get help from PlanetScale's support team, or join our GitHub Discussion board to see how others are using PlanetScale.