Skip to main content
Last Reviewed: December 13, 2022


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

Current Host

How Site Was Created

Additional Requirements
PantheonEmpty UpstreamMultidev

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 Terminus commands. Before you begin, set the variables $site and $env in your terminal session to match your site name and the correct environment:

export site=yoursitename
export env=dev

The following aliases are used as examples:

  • 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:

  • Ensure your site has the Pantheon empty repository in its upstream.

    • Use Terminus to confirm the empty Upstream

      Run the command terminus site:info $SITE to display the site's basic information and properties.

      The following is an abridged example of the output for a site upstream set to empty:

      terminus site:info $SITE
      ------------------ -------------------------------------------------------------------------------------
      ID                 abdc3ea1-fe0b-1234-9c9f-3cxeAA123f88
      Name               anita-drupal
      Label              AnitaDrupal
      Created            2019-12-02 18:28:14
      Framework          drupal8
      Upstream           4c7176de-e079-eed1-154d-44d5a9945b65:
      ------------------ -------------------------------------------------------------------------------------

      The following values indicate that a site is using an empty upstream:

      • The Framework is drupal8

      • The Upstream includes

  • The site does not use another package and library manager, such as Ludwig.

  • You have not set up Continuous Integration or you no longer need it.

  • The trusted host setting is up-to-date. Refer to the Trusted Host Setting documentation for more information.