Matt Harris

Key Takeaways

  • WP Engine follows best practices for site migration. They recommend specific steps to ensure a successful migration to another hosting environment.

  • Create a backup checkpoint and download the zip file. This ensures you have a copy of your site’s files for the migration process.

  • Replace wp-config.php with new database credentials. This step is crucial for connecting your site to the new hosting environment.

  • Consider running a search and replace on your database. This helps update any remaining instances of your live domain.

  • Download your LargeFS files from Amazon S3 if applicable. This ensures all your site’s files are transferred to the new host.

  • Contact WP Engine support for expert help if needed. They offer 24/7 support for any migration issues.

Learn how to migrate a WP Engine Site to a different host, whether it’s a local environment or if you want to host the site elsewhere.

WP Engine follows best practices to ensure our functionality is tightly integrated into WordPress®, and our environment is customized to provide the best performance, stability, functionality and security.1 As such, we’ve included a few fine-tuned platform features on each site.

If you choose to migrate away from WP Engine or need to setup a local development environment, you’ll need to follow these steps to ensure your success.

Note

We recommend developing locally with Local, which is free for everyone. It also integrates directly with your WP Engine environment for easy deploys.

Migration Process

WP Engine recommends the following workflow when copying your WP Engine site another hosting environment (for instance, copying to a local environment or another web host):

  1. Create a backup checkpoint
  2. Once the backup is complete, select the backup and click Download Zip
  3. Once you receive the email containing your zip file, open the zip and delete the following:
wp-content/advanced-cache.php
wp-content/object-cache.php
wp-content/mu-plugins/mu-plugin.php
wp-content/mu-plugins/wpengine-common/
wp-content/mu-plugins/slt-force-strong-passwords.php
wp-content/mu-plugins/force-strong-passwords/
wp-content/mu-plugins/stop-long-comments.php
wp-content/mu-plugins/wpe-wp-sign-on-plugin/
wp-content/mu-plugins/wpe-wp-sign-on-plugin.php
wp-content/mu-plugins/wpengine-security-auditor.php
  1. Upload the rest of the files to the new environment
  2. Your database can be found at wp-content/mysql.sql
    • You will also want to retain a copy of this file on your local computer until you are confident all content was imported correctly.  After this is completed, we suggest you remove this file from your new hosting environment.
  1. Replace wp-config.php with the default WordPress template.
    • Be sure to include your new site’s database credentials. These can be found in MySQL on your new host, or local environment.
  2. (Optional) You may choose to run a search and replace on your database to update any remaining instances of your live domain or the WP Engine default domain to your local host domain.
  3. (Optional) If you use LargeFS on your WP Engine environment, download your files from Amazon S3 and upload them to your new host.

Your site should be up and running on your new environment after following these steps!

NEXT STEP: Learn about your WP Engine Account

Tags:

You may also like