It looks like you are ready to move your site over to the WP Engine platform. Our automated migration tool, powered by BlogVault, makes moving your WordPress website to WP Engine extremely easy! Let’s get started on how to use the tool.
Check out our amazing Webinar that will walk you through every step!
If you run into any problems, please check out our Common Errors section further down this article.
1. Create New Environment
Before migrating your site using the WP Engine Automatic Migration plugin, be sure you create a new install (or if you are on a Startup, Growth, or Scale plan, create an environment instead) in your User Portal for your site!
To do this:
- Log into your User Portal
- Navigate to the Installs menu and click Add–or if you are on the Startup, Growth, or Scale plan, navigate to Sites and click Add Site instead, and add an environment to your site.
- You will receive an email when your new environment is created
Once your new environment has been created, navigate to the Site migration option in the left-hand navigation menu and follow the next steps to migrate your site!
2. Download WP Engine Migration Plugin
You will need to download and install the plugin on your WordPress install that exists on your current hosting provider. The plugin can be found on the WordPress Plugin Repository. You can search for the plugin in your WordPress dashboard by searching for ‘WP Engine Migration’.
Once the plugin is installed, activate the plugin so that it can be used.
3. Add your Domain in User Portal
When you’re ready to migrate your live domain, our system first needs to know where it will live on our platform. To do this, you will need to add your domain to the User Portal in the Domains section for your production environment. For Personal, Professional and Business plans, learn how to add a domain here, and for Startup, Growth, and Scale plans, follow these steps instead.
Note: This step is not needed on the first run of the migration plugin (for the [environment].wpengine.com address), but it is required for the second run when you use your live domain as the Destination Site URL.
4. Gather Your Credentials
You will need 5 pieces of information to complete the migration:
- Your Email
- Destination Site URL
- WP Engine SFTP Server Address
- WP Engine SFTP Username
- WP Engine SFTP Password
The Email you supply the plugin is the email we will use to communicate updates about your migration.
The Destination Site URL is how the site displays on WP Engine. Whichever URL you place here is what the plugin will set your install’s URLs to. To test your site on our platform, use your install’s WP Engine URL ([environment].wpengine.com) in this field.
Note: When you are ready to move your domain over to our platform and launch the site, run the migration plugin again and use your own domain name in this section. If you are NOT testing first, simply use your domain on the first go.
The WP Engine SFTP Details are the connection details the plugin needs to move all your content to our platform. You will have received an email from us titled WP Engine New Site Confirmation. This will contain a link that says Migrate Your Site Now. Click that link and it will take you to the WP Engine User Portal Migration Page.
Here, you’ll see steps for migrating your site automatically using our Automated Migration plugin, as well as environment details. You will need to click the ‘Generate new SFTP password’ in order to create the SFTP user & obtain the password.
Note: If you did not receive an email with the Migrate Your Site Now link, you can still find the SFTP details you need by visiting the Site migration section in your User Portal.
5. Start Your Migration
You should now have the plugin installed & activated as well as have gathered all the information you need to start the migration.
Go to the WP Engine Automated Migration tab in your WordPress Dashboard. Here you will find several text boxes that we will use during your migration. We strongly recommend that you set the Destination Site URL to your temporary WP Engine URL ([environment].wpengine.com). This will allow you to visit your temporary WP Engine URL to see if the migration completed successfully.
Next, input the information into the plugin and press migrate! The plugin will then forward you to a blogvault.net page that will give you real time updates of your migration. If you see any issues, please refer to our Common Errors section further down this article. You will receive an email once the migration completes.
6. Test Your Site
You should have received an email saying your migration has completed. If you used the WP Engine URL ([environment].wpengine.com), you can visit that URL now in your browser to verify the site moved over properly. After checking it out, if everything looks good then you’re then ready to finish the migration!
7. Finish Your Migration
If the site successfully moved over, you will need to re-run the migration one more time with the SAME email and SAME SFTP credentials. This time however, change the Destination Site URL this time to your live domain.
For example, if your WordPress site is ‘mydomain.com‘, you would then put ‘mydomain.com‘ as the Destination Site URL.
Note: Please ensure you’ve completed the ‘Add Your Domain In User Portal‘ step above before continuing.
Finally, Click migrate again and the tool will re-start the migration for the updated domain. Then you’re all done!
Note: The tool is smart enough to know that this is the second migration. The migration tool will not migrate all your files again. Rather, it will pick up any file changes and additions. Please keep in mind, that the migration tool will migrate the entire database again, essentially wiping all database changes on our system and replacing it with the most up to date database on your current hosting provider.
8. What’s Left to Do?
Now that the heavy lifting is done, you have a few small tasks to complete to officially be on WP Engine. Some or all of these may not apply to your migration:
- Add your domain to the WP Engine User Portal or Add Domain for Startup, Growth, and Scale plans
- Setup your redirects
- Setup SSL
- Update your DNS
Once any applicable steps above are completed, you will be fully on WP Engine. Welcome to the family!
Here are a list of errors that the plugin will tell you if something goes wrong along with the solution:
- Could not connect to server. Please check the address.
The SFTP credentials you provided are incorrect. You can verify that you are using the right SFTP credentials by visiting the Site migration page for your environment in your User Portal.
- That email is already in use.
You are using an old version of the plugin. Please update or re-download the plugin from the WordPress.org plugin system.
- Error! The URL specified is incorrect. Can you please check if your WP Engine account is configured with…
This means that the Destination URL you are using is not set up on the environment you are trying to migrate the site to. Please read Add your domain to the WP Engine User Portal to fix this issue.
- White Screen with an “Unknown” Error
Don’t be afraid, your site is still up and running. This error is caused by the Cloudflare plugin. Please deactivate that plugin and continue with the migration. Once completed, you can re-activate it on WP Engine’s platform.
- The plugin is asking me for an additional username and password. What do I do?
Your WP Engine environment is password protected. This is the case for both transferrable environments and environments that you made password protected via the User Portal. Just input the username and password for the password protected site. You can find the username and password in the User Portal.
- Don’t change any settings in the WP Engine User Portal during the migration.
The Automated Migration plugin does a lot of proactive checks to ensure the migration is going smoothly. When settings change during the migration, this can trigger one of those checks to fail resulting in a failed migration.
Known Host Incompatibilities
After extensive testing, we have found a few hosts that the plugin cannot migrate you away from. These hosts are, but not limited too:
- Local Hosting Environments
- Proprietary Hosting Providers (Wix.com, SquareSpace.com, and other similar companies)