Skip to main content
Log inGet free account
Last Reviewed: December 13, 2022

Migrate

Learn how to use the Acquia migration path.

Discuss in Slack
Edit this page on GitHub Report an issue with this doc

Pantheon provides an Acquia path for migrating existing sites to the platform. This process begins by clicking the Migrate Existing Site button on either the workspace Home Page or Sites tab.

The recommended way to migrate Drupal sites from another host is to use drush ard (Drush 8 or 11) to create an archive that can be easily imported.

  1. Open your Personal or Professional Workspace dashboard and click the Migrate Existing Site button.

    Migrate site button

  2. Enter your current website URL, select Drupal 7 or Drupal 8, and click Continue.

    Enter URL and select CMS

  3. Enter the name of your new Pantheon site, select a workspace for the site (optional), and click Create Site.

    Install Plugin

  4. Follow the instructions to Create an Archive of Your Existing Site With Drush:

    The Dashboard instructs you to put the archive on your existing website, but you can put the site archive on Dropbox, S3, or any number of other places. The important thing is that you have a site archive that can be downloaded via a publicly accessible URL.

    Click Continue Migration

    Drupal create archive

  5. Paste the publicly accessible URL to a download of your site archive on the right side of the page. If you are using a Dropbox URL, change the end of the URL from dl=0 to dl=1 so we can import your site archive correctly. Click Import Archive.

    Import archive

  6. Click Visit the Site Dashboard from the Site Dashboard on Pantheon after the import is complete.

    Successful Drupal Migration

Review Troubleshooting or contact Support if the migration is unsuccessful. Include a link to the Site Dashboard and any details you can provide, such as where you are migrating the site from.