Migrate an existing non-Pantheon hosted Drupal site to Pantheon

Discuss in our Forum Discuss in Slack

This guide will show you how to migrate an existing non-Pantheon hosted Drupal site to Pantheon's platform.

Current Host

How Site Was Created

Additional Requirements

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.


Confirm that you meet the following requirements before continuing:

  • Your site is based on the drupal/legacy-project template or a similar non-composer managed structure.

  • You are able to run drush commands in the existing site.

  • You are able to check out your existing site codebase in your local machine.

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

  • You have a brand new Drupal Pantheon site to host your project.

More Resources