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 install to WP Engine extremely easy! Let’s get started on how to use the tool.
If you run into any problems, please check out our Common Errors section further down this article.
1. 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. You can find the plugin 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.
2. 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 install. Full details on setting up a domain can be found: here
Note: This step is not needed on the first run of the migration plugin (for the yourinstallname.wpengine.com address), but it is required for the second run when you use your live domain as the Destination Site URL.
3. 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 (yourinstallname.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 manually as well as a button in the top right for ‘Automate your site migration‘. Click this button and it will take you to a page with all of your 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 https://my.wpengine.com/installs/install-name/migrate-my-site where install-name is the name of the install you want to migrate your site to on WP Engine.
4. 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 (yourinstallname.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.
5. Test Your Site
You should have received an email saying your migration has completed. If you used the WP Engine URL (yourinstallname.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!
6. 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 a second migration. The migration tool will not migrate everything again. However, it will pick up any file and database changes or additions and migrate them over. This results in a faster migration.
7. 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:
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 https://my.wpengine.com/installs/yourinstallname/migrate-my-site where yourinstallname is replaced by the install name you would like to migrate your site to.
- 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 install you are trying to migrate the site too. 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 install is password protected. This is the case for both transferrable installs and installs 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. Please visit our support article to learn more about Transferrable Installs.
- Don’t change any setting 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)