Skip to main content
Last Reviewed: December 12, 2022


This guide will show you how to migrate a site that meets the following criteria to the latest version of Drupal:

Current HostHow Site Was Created
Additional Requirements

This guide is intended for those who do not have access to Multidev. If you do have access, use Upgrade a Drupal Site with Multidev to the latest version of Drupal Using Multidev instead.

If this is not your scenario, see Drupal Migration Guides for additional upgrade paths.


This upgrade migrates your existing site to a new site. The new site will not maintain your site’s commit history.

This doc uses the following aliases:

  • Alias: D8_SITE
    • Site Name: best-drupal8-site-ever
  • Alias: DRUPAL_SITE
    • Site Name: best-drupal-site-ever


Confirm that your site meets the following requirements before you continue:

  • The site cannot be set to use an empty upstream.

  • The site does not use another package and library manager like Ludwig.