Skip to main content
Last Reviewed: 2025-12-05

Migrate

Perform the migration.

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

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

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.