These are the steps you’ll need to take to migrate your WordPress website to Kinsta using Migrate Guru:
This guide is provided to help you perform your own migration. However, please note that Migrate Guru may not be fully compatible with some WordPress sites. Our support team is always happy to help with basic migration questions, but cannot assist with failed migrations after the fact, as this falls outside of the scope of our support.
All of our plans include one or more free migrations. If you’re at all worried about the integrity of your data, we highly recommend using our professional migration team. Additional migrations can be purchased for a one-time fee of $100 and we also offer bulk migration pricing.
Add a Site in MyKinsta
Once you’ve signed up for a Kinsta hosting plan, to use Migrate Guru you’ll need to add a site in MyKinsta.
When creating the site, be sure to select the Install WordPress option.
What Domain Should You Use?
When you create the site, you’ll have the option to specify a custom domain.
Adding your live domain as a custom domain will result in MyKinsta creating an install that’s set up to use your live domain right from the start. If you don’t add a custom domain the site will be set up to use temporary Kinsta subdomain.
Either option can be used when migrating your site. However, your choice here will have implications later in the migration process.
- If you use a custom domain you will need to edit your hosts file or use the hosts.cx tool to preview the site before having the migrated site go live.
- If you use the temporary Kinsta domain you will need to add a custom domain and search-replace the site database before you’ll be able to go live with the migrated site.
Using a custom domain will make it a little harder to preview the migrated site but easier to go live with the migrated site when you’re ready to go live. Using the Kinsta subdomain will do the opposite: previewing the migrated site will be easier but going live will require a few additional steps.
In our experience, we’ve found that being able to preview the site with a temporary domain is very important for users migrating to Kinsta. Thus, we recommend leaving the domain name field blank during site creation, and migrating to the provided kinsta.cloud domain to start.
After you have verified the migrated site, you can assign a custom domain and perform a search and replace on your site to move to your live domain.
The rest of the fields in the form in MyKinsta can be filled in however you like. Once the migration has been finished the WordPress site name and user will be overwritten.
Once you’ve filled out all of the fields click Add Site. MyKinsta will need a few minutes to set up your site. So while that’s happening go ahead and move on to the next step.
Install Migrate Guru
While the site is being created in MyKinsta, log into your existing website. Once you’ve logged in to the WordPress admin area navigate to Plugins > Add New and then search for Migrate Guru.
Once you locate the plugin go ahead and install it.
Initiate the Migration
After installing Migrate Guru, activate the plugin. Once activated, you’ll be redirected to the Migrate Guru admin menu. If you happen to click away and need to find your way back, you can find this screen by clicking on Migrate Guru in the WordPress admin menu.
On the following menu, select Kinsta for the “host you are migrating to”.
Domain and SFTP Details
Next, go back to MyKinsta and gather the domain and SFTP details for the site you just created.
Find your kinsta.cloud domain in Sites > [your-site] > Domains.
Find your SFTP username, password, port, and directory path in Sites > [your-site] > Info.
If you’re unsure where to find these details, our article on How to Use SFTP can help you locate them. Once you have the necessary details enter the details into Migrate Guru.
Important Migration Details
Below are very important migration settings you must configure properly, otherwise, you won’t be able to get to the next screen.
- Destination Site URL – You need to include the protocol of your site, whether it is https:// or http://. For kinsta.cloud domains, you can use https://.
- Directory Path – Make sure to use the full path /www/sitename_123/public as shown in your MyKinsta dashboard.
Start the Migration
Next, input your kinsta.cloud domain in the “Destination Site URL” field in Migrate Guru, and add your SFTP details and directory path. After you have verified the details are correct, scroll down and click the Migrate button to start the migration.
Migrate Guru will now test the SFTP credentials you provided. If any problems are encountered Migrate Guru will return to the SFTP details screen and highlight the fields that need to be reviewed. Check the details, correct any mistakes, and click Migrate again.
If you don’t enter the correct directory path or destination address you’ll receive the following error:
Unable to access wpconfig file. Please check if WordPress is installed on the destination address. Also, check if you have permission to access the folder.
If Migrate Guru repeatedly reports issues with the SFTP details please contact our support team for assistance. Multiple failed SFTP connection attempts can trigger an IP address ban.
Once the connection is made successfully Migrate Guru will migrate the site and display a page which you can use to monitor the progress of the migration. Depending on the size of your WordPress site, the migration can take a while.
When the migration is finished, you’ll see a page that says “migration completed successfully”.
Test the Migrated Site
After the migration is finished, you can test your site using the kinsta.cloud domain. In the screenshot below, our migrated site is accessible over kinstalifenew.kinsta.cloud, and looks exactly like our previous site at kinstalife.com.
Switch to Your Live Domain
If you used a Kinsta subdomain to preview your site, you can switch the site to use the live domain. Follow these steps:
- Create a manual backup of your site which you can restore if something goes wrong during this process.
- Add your live domain to the site and make it the primary domain.
- Run a search-replace of the site database to update all instances of the URL in the database.
- Clear the site cache.
- Edit your hosts file or use the hosts.cx tool to preview your site and confirm that it loads properly at the live domain.
After confirming that the site loads properly using the live domain update your DNS and point your live domain at Kinsta.
(Optional) Migrate Your SSL Certificate
If your current site uses an SSL certificate and loads over https you will need to install an SSL here at Kinsta to keep the site loading over https. Depending on the type of SSL you’re using there are a few steps that may need to be taken:
- If you have purchased a premium SSL certificate, you can simply install the same certificate here at Kinsta.
- If you are presently using a free SSL at your current host and wish to use Kinsta’s free SSL option, you will need to wait on installing the SSL until the site is loading from Kinsta. Once the site is loading from Kinsta the free SSL can be generated.
Once the SSL is installed you will need to run a search-replace of the site database to update every occurrence of the site URL in the database from http to https. Our post on fixing mixed-content warnings includes a detailed description of how to update these URLs.
Once the site is successfully loading over https, you can use the Force HTTPS tool in the MyKinsta dashboard. This will cause all http requests to be redirected to https ensuring your site can only be accessed over https.
Install Kinsta MU-Plugin
Our Kinsta MU-plugin is automatically installed on fresh WordPress installations done here at Kinsta. However, since you’ve migrated your site yourself, you’ll need to download and install the Kinsta MU plugin manually. This includes our full page caching and other functionality such as the ability to deploy the Kinsta CDN.
Step 1: Download and Unzip the Plugin
First, download the Kinsta MU-plugin and unzip it.
Step 2: Upload to Site
You’ll then need to connect to your site via SFTP and upload the
kinsta-mu-plugins folder and
kinsta-mu-plugins.php file to the
/wp-content/mu-plugins/ directory doesn’t exist, create it first and then drop in the above file and folder.
If you enjoyed this tutorial, then you’ll love our support. All Kinsta’s hosting plans include 24/7 support from our veteran WordPress developers and engineers. Chat with the same team that backs our Fortune 500 clients. Check out our plans