Migrate between regions
In this article you learn how to move a project from one region to another on Umbraco Cloud.
Last updated
In this article you learn how to move a project from one region to another on Umbraco Cloud.
Last updated
Creating a project on Umbraco Cloud, you can choose to host the project in different regions: East US, West EU, 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.
A clone of both East US and West EU projects.
A local setup that can run an Umbraco instance. Learn more about this in the Requirements article.
If you want to migrate an Umbraco 8 project, you will need to upgrade to the latest supported Long-Term-Supported (LTS) version of Umbraco CMS.
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.
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.
Find more details on how to upgrade your project in the Upgrades documentation.
The following steps will guide you through the migration process.
Make sure that your projects are prepared for migration before continuing the process.
Go to Configuration > Backups on the West EU Cloud project.
Create a backup of the projects database.
Download the backup to your local machine.
Go to the East US project.
Go to Configuration > Backups.
Upload the database backup that you created in the previous step to the project.
Restore the backup to your environment
Optional: Create a backup of the environment before restoring the backup.
Run Export Schema from the Deploy Dashboard in the Settings section of the East US project.
Run Update Umbraco Schema from the Deploy Dashboard in the Settings section of the East US project.
Once you have restored the database to your environment, go to the backoffice of the project you are migrating to. In the backoffice, you should now see your content in the Content section, Document Types, and Data Types in the Settings section.
Taking a closer look at the templates, stylesheets, scripts and media, you will notice that it is not there. In the next step we will migrate those over to our new project
In this step, we will migrate our files and media items from our project in the EU region.
Clone down both the projects to your local machine.
Run the local East US project and restore the content.
Open both the project folders for West EU and East US.
Move the view files located in the view folder from West EU to the view folder in the East US project.
When prompted replace the existing files.
Move the CSS and Script files located in the wwwroot folder from the West EU folder to the wwwroot folder in the East US project.
Optional: Move files from App_Plugins if you have extended the Umbraco Backoffice
Move custom code (Models, Controllers and other relevant code) from the West EU to the East US project
Run the East US project locally.
Once you have started the project, it should show your content as it was on the West EU project. The only thing missing is the media items, as they have not been migrated yet. Before we can migrated our media items, we need to push the migrated files to the Cloud project.
In the following steps, we will push the migrated local East US project back up to the project on Cloud.
Follow the Deploying Changes article to push the Views, CSS and JavaScript files to the Cloud environment.
Follow the Transferring Content, Media, Members, and Formsarticle to transfer the media items to the cloud project.
Verify that all schemas, files, and content have been successfully deployed to your new US project after the transfer.
In the following steps, we will migrate the media items from the West EU blob storage container to the East US blob storage container.
Follow the guide in the Connect to Azure Storage Explorer article to access the Azure Blob Storage container connected to both the West EU and East US environment.
Locate the media files for the West EU Umbraco project.
Download the West EU media folder from the Azure Storage Explorer.
Go to the East US blob container.
Upload the West EU media folder to the East US blob container.
Reload the front end and backoffice of the East US project to verify that the images have been added correctly.
When the media folder has been moved to the migrated 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 contact@umbraco.com.
