Migrate between regions
In this article you learn how to move a project from one region to another on Umbraco Cloud.
When creating a project on Umbraco Cloud, you can choose to host the project in different regions: East US, EU West, South UK, or East Australia.
In some cases, you might want to migrate your project(s) from one region to another. This article will outline the steps to do this.
The East US and West EU regions will be used as examples in this article.
- Admin access and deployment rights on the project that is to be migrated.
- Git is installed locally as well as a Git client like Git Bash.
To follow this guide, it is highly recommended that you have experience with Git and running git commands through a command line tool.
The first step in this process is to create a new Umbraco Cloud project in the region you want to migrate your existing project to. In this case that will be the East US region.
This is done by selecting East US from the Region dropdown when creating the Cloud project.
Select the East US region
The new project in the US region will run the latest version of Umbraco CMS, Umbraco Forms, and Umbraco Deploy. You will need to ensure that the project you are migrating is running the exact same version of each product before initiating the migration process.
The following steps will guide you through the migration process.
Umbraco 10+
Umbraco 8
- 1.Clone down the project that you want to migrate - the EU project.
- 2.Restore content and media through the Umbraco backoffice.
- 3.Clone down the new Cloud project created in the US region - the US project.
- 4.Replace the
src/UmbracoProject/umbraco-cloud.jsonfile in the EU project with the one from the US project.
The
umbraco-cloud.json file contains details about each environment on the Cloud project.By replacing the one on the EU project with the one from the US project, content, and media transfers will point to the environments on the US project instead of the EU project.
- 5.Commit the change through git, but do not push it yet.
- 6.Use the following git commands to connect your local EU project to the live environment on the US project:
git remote rm origin
git remote add origin https://scm.umbraco.io/useast01/name-of-us-live-site.git
git fetch
git branch --set-upstream-to=origin/master
- 7.Push the schema and files from the EU project to the US project using the following git command:
git push origin master -f
- 8.Verify that the schema and files have been merged into the live environment on the US project.
- 9.Transfer content and media from the local EU project to the US project.
- 10.Verify that all the content and media have been transferred to the US project.
- 1.Clone down the project that you want to migrate - the EU project.
- 2.Restore content and media through the Umbraco backoffice.
- 3.Clone down the new Cloud project created in the US region - the US project.
- 4.Replace the
Config/UmbracoDeploy.configfile in the EU project with the one from the US project.
The
UmbracoDeploy.config file contains details about each environment on the Cloud project.By replacing the one on the EU project with the one from the US project, content, and media transfers will point to the environments on the US project instead of the EU project.
- 5.Commit the change through git, but do not push it yet.
- 6.Use the following git commands to connect your local EU project to the live environment on the US project:
git remote rm origin
git remote add origin https://scm.umbraco.io/useast01/name-of-us-live-site.git
git fetch
git branch --set-upstream-to=origin/master
- 7.Push the schema and files from the EU project to the US project using the following git command:
git push origin master -f
- 8.Verify that the schema and files have been merged into the live environment on the US project.
- 9.Transfer content and media from the local EU project to the US project.
- 10.Verify that all the content and media have been transferred to the US project.
Once you have verified that all schema and files as well as content and media have successfully been deployed and transferred to your new US project the migration process is complete.
It is highly recommended to thoroughly go through everything on the migrated site to ensure that everything works as expected.
Following the steps above you have migrated your Umbraco project from one Cloud environment to another.
The following will need to be reconfigured on the new project after the initial migration:
- All Team Members added through the Cloud Portal on the EU project also need to be invited to the migrated project
- Hostnames, certificates, and other related settings must be re-added and reconfigured on the migrated project.
Once everything has been configured and set up you can safely delete the EU project which will also cancel the running subscription on the project.
If you need help or have any questions regarding this process, please contact our support using [email protected].
Last modified 1mo ago