There are many scenarios in which you might prefer running a site within an International Region rather than the default US. Common use cases include:
- Compliance standards that require data residency within the borders of Australia, Canada, or the European Union
- Improved performance and user experience for authenticated traffic originating near the desired region
Four regions are available when creating a new site:
- United States (US) (Default)
- Australia (AU)
- Canada (CA)
- European Union (EU)
A Pantheon site has all site resources located in the region in which it was created. This includes application and database containers, Redis cache servers, Apache Solr index servers, and a distributed filesystem and request router.
Automated and manual backups of all site components (code, database, and files) are stored in the site's region and created by job workers also running in the site's region. Additionally, any database or file clones between site environments are run by job workers in the site's region.
Localized, region-specific Disaster Recovery is also available.
With this set of region-specific resources, you can run WordPress or Drupal sites on Pantheon and meet your region's legal, regulatory, or data sovereignty requirements.
Create a new Site from the Dashboard and select the Region:
- Install and authenticate Terminus. The commands used for International Regions require Terminus 2.0 or newer. If you're already running Terminus, be sure to update to the latest version.
- Use Terminus to create a new site associated with your organization and include the
- Available regions:
For example (replace
My EU Site Name,
My Organization Name accordingly):
terminus site:create my-eu-site-name "My EU Site Name" "WordPress" --org "My Organization Name" --region eu
terminus site:create --help for more information on the options and values used in this command.
- Create a new site (as described above)
- Copy over the site's code, database, and files.
- For details see How to Manually Migrate Sites to Pantheon.
- Move domains and DNS to the new site.
- For more info see the Relaunch Procedure doc.
If you'd like help migrating your site between regions, our Professional Services Migrations team is available.
Use the Dashboard to see the Pantheon Region in which the site is hosted:
- Navigate to the Site Dashboard
- Click Settings, then About Site
- Region will show either
United Statesby default, or the name of the International Region in which the Site is hosted.
You can also get this information via Terminus.
In the following sections, assign
$SITE or replace it in each example with your site name or UUID.
terminus site:info $SITE
terminus site:list --org "My Organization Name" --fields name,region
grep to expose the
x-served-by response header or
AMS to verify whether the Amsterdam origin shield was used as expected (replace
curl -Is https://example.com | grep x-served-by
curl -Is https://example.com | grep AMS
The output should look something like:
curl -Is https://dev-rachel-whitton-eu2.pantheonsite.io | grep x-served-by x-served-by: cache-ams21041-AMS, cache-jfk8127-JFK
Yes, however you must migrate your existing site to a new site that was configured for the new region during creation (as described above).