WP Engine Automated Migrations is a plugin which enables you to migrate your entire WordPress installation to your WP Engine server. All you need to do is enter your WP Engine SFTP credentials into the plugin settings and follow these steps.
1. CREATE A NEW INSTALL
Before migrating your site using the WP Engine Automatic Migration plugin, be sure you create a new install in your User Portal for your site!
To do this:
- Log into your User Portal
- Hover over “Installs”
- Click “Add Install”
- Fill in the boxes and click “Create”
- You will receive an email when your new install is created
Once your new install has been created, 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. 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.
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 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.
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 (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.
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 (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.
6. 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!
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:
Once any applicable steps above are completed, you will be fully on WP Engine.Subscribe for new Genesis Tutorials