Migrating to the new Umbraco Cloud infrastruture

    In this article, you’ll find all relevant information to be aware of when a site is migrated from the old to the new Umbraco Cloud infrastructure. This article is kept up-to-date should any new information arise.

    Schedule and timing

    Projects are scheduled for migration through Q4, 2021. When a project is scheduled the project owner and technical contacts will receive direct communication via email with the specific date and time.

    Rescheduling migration

    In case the timing of the migration schedule does not work for you, it is possible to reschedule by reaching out to [email protected].

    Minimum requirements for migration

    In order for an Umbraco Cloud project to be scheduled for migration, the following requirements need to be fulfilled.

    Minimum version requirements

    The new infrastructure comes with minimum requirements on what version of Umbraco CMS and add-ons. In order to be scheduled for migration projects must run:

    Umbraco 8

    Minimum required version
    Umbraco CMS 8.6.7
    Umbraco Forms 8.4.4
    Umbraco Deploy 4.0.5

    Umbraco 7

    Minimum required version
    Umbraco CMS 7.7.6
    Umbraco Forms 6.0.8
    Umbraco Deploy 2.0.18

    You can find the Umbraco CMS, Forms and Deploy version for each environment listed on the project page in the Umbraco Cloud Portal:

    Version numbers on Umbraco Cloud environments

    More information on upgrading can be found in the documentation article for upgrading to the latest minor or if you’re using the UaaS.cmd tool refer to the manual upgrade documentation.

    Projects that do not meet the requirements, cannot be scheduled for migration to the new infrastructure.

    Updated DNS settings - you might need to update settings

    Your projects need to be updated to use the new Cloudflare DNS settings. All CNAME records must point to dns.umbraco.io. If you require an A-Record this must point to or See the Manage Hostnames documentation for detailed instructions.

    You can see if you are using the new Cloudflare DNS settings or the “old” Let’s Encrypt under Project settings -> Hostnames:

    Before the migration

    A project is only scheduled for migration when all the requirements are met. If outgoing IP addresses on Umbraco Cloud are being used, i.e. adding them to an allow list, note that these will change when the project is migrated to the new infrastructure. In this case, it is recommended to add the new outgoing IP addresses to the allow-list prior to the migration. See the Using external services with Umbraco Cloud documentation for the full list and more information.

    No other actions are required prior to migration.

    During the migration

    We kindly ask users to hold off working on the project during the 4-hour migration window to ensure that deployments and other Umbraco Cloud services are not interrupted.

    Please do not:

    • Interact with the backoffice on Dev/Stage/Live env.
    • Update schema in the backoffice on Dev/Stage/Live env.
    • Update project settings in the Cloud portal
    • Initiate deployments between environments in the Cloud portal
    • Interact with Git repositories(sync/push/pull)

    Work on the project(s) can resume immediately after receiving confirmation of a successful migration.

    After the migration

    New Umbraco Cloud project URL

    The project URL will change from my-project-alias.s1.umbraco.io to my-project-alias.euwest01.umbraco.io. It is only the project URL that changes. Custom hostnames will continue to work as before.

    New GIT repository URL

    There will be an improved repository URL you can switch to, but it is not required as part of the migration. The GIT repository will still be accessible from the same URL as before and any custom domains assigned to the project will continue to work as expected.

    We’re moving away from the rather verbose GUID-based URLs that are used on Cloud currently to something resembling what you already know from i.e. Github.


    will become


    This brings a whole host of advantages both for local development, password management and adds more flexibility overall. If a site has been migrated from the old infrastructure, the old GUID-based URL will continue to work after the migration as we do not want to break any potential CI/CD setup.

    New outgoing IP addresses (for allow lists)

    The outgoing IP addresses on Umbraco Cloud will be changed once the projects are running on the new infrastructure. This is only relevant if you are working with an allow list. In this case, please add the new outgoing IPs prior to migration.

    Additional information

    Several blog posts has been published detailing the journey to the new and improved infrastructure: