Skip to main content
Last Reviewed: June 15, 2021

Migrate

Perform the migration.


Pantheon provides a guided path for migrating existing sites to the platform. This process begins by clicking Migrate Existing Site.

The recommended way to migrate WordPress sites from another host is to use the Pantheon Migration plugin, developed by BlogVault.

Watch: Guided WordPress Migrations
  1. Open your Personal or Professional Workspace dashboard and select the Migrate Existing Site button on the lower right side of the page.

    Migrate site button

  2. Enter your current website URL, select WordPress, 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. Select Generate Machine Token and re-authenticate if prompted.

    Begin process of installing plugin

  5. Select Install on /wp-admin. A new tab will open with your WordPress CMS for your existing site. Keep the Pantheon tab open in your browser. Install on /wp-admin

  6. Search for and install the plugin.

    Searching for plugin on WordPress

  7. Click Activate.

    Copying and pasting info

  8. Go back to the browser tab containing your Pantheon dashboard, copy the machine token from the Pantheon Dashboard, then go back to the WordPress Dashboard on your existing site. Paste the machine token and the site name, and click Migrate.

    Copying and pasting info

    When the migration is complete, the Migration completed successfully page appears.

    Migration successful

    You will also receive an email when the migration completes.

  9. Go back to the Pantheon tab and click Confirm migration progress. Your site's dashboard appears.

Info:
Note

The WordPress Native PHP Sessions plugin is automatically installed during the migration process. For more details on this plugin, see WordPress and PHP Sessions.

You now have a Dev environment containing your migrated site, including your Content Management System (accessible via the Site Admin button).

To create your Test environment:

  1. Go to the Site Dashboard.

  2. Click the Test tab, then click Initialize Test Environment to create your Test environment.

    Initializing the test environment

    This takes a few moments.

  3. Go to the Database / Files tab and select the following:

    • From this Environment: Development
    • Clone Database: Checked
    • Clone Files: Checked
  4. Click Clone the Database & the Files from Development into the Test Environment.

    Cloning Dev to Test

To create your Live environment:

  1. Go to the Site Dashboard.
  2. Click the Live tab.
  3. Click Initialize Live Environment to create your Live environment.

Initialize live environment

  1. Go to the the Database / Files tab and select the following:

    • From this Environment: Development
    • Clone Database: Checked
    • Clone Files: Checked
  2. Click Clone the Database & the Files from Test into the Live Environment.

    Clone test to live

  3. Type "CLONE" and then click Overwrite This Environment when prompted to confirm you want to go live.

    Confirm cloning

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.