Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

⚠️ Important: Make sure that you follow pantheon guide for Drush and the machine token otherwise non none of this is going to work.

...

Pull the database from Pantheon ( I am skipping files and only pull pulling the database because I am not interested in the files, but you can pull the files them as well if you want):

Code Block
languagebash
ddev pull pantheon --skip-files -y

but if you insist on pulling If you want to pull the files as well, you can run the following command:

Code Block
languagebash
ddev pull pantheon -y

Note: See the section below for an alternative method to pull the files.

Terminus

If you are using Terminus, you can use the following command to pull the database:

...

Code Block
languagebash
ddev import-db --file=path_to_dumpfile.sql.gz

DDEV has a pretty straightforward documentation about this.

...

Using the command line tools, sftp client, or any other method, copy the files from your live site to the wp-content/uploads directory in your local environment.

for files, I usually use Bill Erickson's Media From Production to read media files from the live site and save myself a couple of GBs of storage. The plugin is a real gem!

...

After pulling the database from Pantheon, you need to update the URLs and paths to match your local environment. Use the
wp search-replace command:

Code Block
languagebash
ddev wp search-replace 'live-yoursite.pantheonsite.io' 'yoursite.ddev.site'

Replace '<live-yoursite.pantheonsite.io>' with your actual Pantheon live URL, and '<yoursiteyoursite.ddev.site>'
sitewith your local DDEV URL. Note that you may also need to specifically target the wp_options table, wp_blogs, and wp_sites as well, otherwise, you may be seeing redirections from your local to the live site when you attempt to browse your network sites locally. So:

Code Block
ddev wp search-replace 'live-yoursite.pantheonsite.io' 'yoursite.ddev.site' 'wp_*options' wp_blogs wp_site --network

!! Important: Note the * before wp_options which means the options tables for all the sites in the network.

...

Code Block
languagebash
ddev wp user create your_username_here your_email_here  --role=administrator --user_pass=yourpassword

Update a wordpress user the new WordPress user’s role:

Code Block
languagebash
ddev wp user update the_id_of_the_user_here --role=administrator

...

Make your user a super admin, because if otherwise you are not already, you will not be able to access the network admin area:

...

By following these steps, you'll have a fully functional local WordPress multisite environment set up with DDEV,
supporting subdirectory installs and integrated with Pantheon. This setup provides a robust development environment for
working on WordPress multisite projects.

The wp search-replace command is crucial for ensuring that your local site works correctly with the database pulled from the live version.