Skip to main content
Last Reviewed: 2022-12-12

Upgrade the Code


  1. From the local Drupal site's directory, use Terminus to retrieve the existing site's Git URL:

  2. Add the existing site as a remote repository called existing. Use the URL retrieved in the previous step:

  3. Copy over exported configuration from the original site. From your Drupal site, run the following commands:

  4. Compare your current pantheon.yml file with the new drupal pantheon.upstream.yml:

  5. If you have customizations in your existing site's pantheon.yml that you want to keep for Drupal (e.g., a Quicksilver script or site-specific protected web paths), copy pantheon.yml over:

  6. Copy over any Quicksilver scripts referenced in pantheon.yml:

  7. List contrib modules and themes on your existing site:

    The command pm:projectinfo assumes Drush 8. If you encounter an issue with this command, verify and configure the Drush version before you continue.

  8. Use Composer on your new site to add these there:

  9. Copy over any custom modules or themes from your existing site:

  10. Check settings.php for any customizations to copy over:

  11. Copy your files and database from your existing site to the new site:

    Information:
    Note

    The Site Clone plugin must be installed to use the terminus site:clone command. Visit https://github.com/pantheon-systems/terminus-site-clone-plugin for details on installing the Site Clone plugin.

  12. Push the new codebase from your local machine up to Pantheon:

  13. Run database updates: