Some of you may prefer to migrate your WordPress site yourself, maybe due to sensitive data or perhaps you just want to do it immediately rather than coordinating with us. For migrating your site to Kinsta we highly recommend using the free WordPress Duplicator plugin, and therefore we’ve put together this in-depth guide for you.
However, please note that Duplicator 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.
Overview of Duplicator Migration
Duplicator generates two files: a zip file containing an archive of all files and the database, and an installer.php file that can be used to restore the site using the archive.
Once you’ve generated the archive file and downloaded both the archive file and the installer.php file, you simply upload those two files to your new Kinsta site and then run the installer.php file by accessing it using your temporary Kinsta URL.
Duplicator will then walk you through the restoration process. During the restoration process, you will be asked for the new database connection details. You will need to copy and paste the database access details found on the Info tab for the site in MyKinsta.
Duplicator will then update your wp-config.php file and rewrite the URLs in the database with the temporary Kinsta URL (e.g., example.kinsta.cloud). Rewriting the URLs will allow you to test your site as hosted on Kinsta without actually pointing your live site to Kinsta. (We’ll do that at the end once you’ve confirmed the site was migrated without issue, at which point we’ll also reverse the URL rewriting process to swap the temporary URL with your live URL in the database.)
- Preparing for the migration
- Creating the archive
- Restoring the archive
- Previewing your site before updating DNS
- Updating DNS
- Install Kinsta MU-plugin
Preparing for the Migration
Migrating a Multisite
If you’re migrating a WordPress Multisite network, there are a few things you’ll need to take into consideration. If you’ll be migrating a subdirectory multisite, you’ll need to contact our Support team so they can enable the necessary Nginx configuration for subdirectory multisite.
We also recommend reviewing the WordPress Duplicator plugin documentation for migrating WordPress Multisite. Other than the additional steps noted in Duplicator’s documentation, the steps below still apply.
Create a Backup on your Current Host
If your existing web hosting company has a way to create a full-site backup, go ahead and do that before proceeding with the migration. The migration process itself should not have any effect on your live site, but it doesn’t hurt to create a backup beforehand and backups are always a good idea.
If your existing web hosting company does not have an option to create a full-site backup, then you can skip this step.
Create the Site on Kinsta
Create a new site inside your Kinsta account for this migration. In MyKinsta, go to Sites and click the Add Site button. In the modal/pop-up that appears, choose Don’t install WordPress (we’ll be migrating your existing WordPress site over, so there’s no need to install WordPress).
Creating the Archive
The next step is to create an archive of your current site using the Duplicator plugin. In this section, we’ll install the WordPress Duplicator plugin on your site, build an archive package that includes all your files and database, and download the archive and the installer.php file.
Disable Caching Plugins
Caching can cause problems during migrations, so it’s best to disable any caching plugins (e.g., Autoptimize, W3 Total Cache, etc.) before creating the archive that you’ll transfer to Kinsta. We have a list of banned plugins that you’ll also want to review.
Install and Activate the Duplicator Plugin
On the WordPress Dashboard for the website you want to migrate, navigate to Plugins > Add New and search for “Duplicator”. Install and activate “Duplicator – WordPress Migration Plugin”.
Create the Site Archive
Once you have activated the Duplicator plugin, go to Duplicator > Packages and click the Create New button to create a new archive package.
Follow the prompts through the three steps to build an archive package. In most cases, you should be able to use the default settings.
It’s highly recommended that under the Installer option you enable password protection.
Download the Archive and Installer File
Once the archive package has been built, download both the Archive file and the Installer file to your local computer. You’ll need to upload these files to your new Kinsta site in the next step.
Restoring the Archive
Transfer the Archive and Installer File to Kinsta
The next step is to upload the archive package and the installer file to your new Kinsta site via SFTP (see how to use SFTP). Upload both files to the public/ directory. The public/ directory should be empty. If it’s not empty, you might already have a WordPress installation on this site and you should remove that before uploading and restoring the archive.
Restore the Archive
Once you have uploaded the archive file and the installer file, you can run the Duplicator installer by visiting the installer.php file in your browser using the temporary Kinsta URL. You’ll find the temporary Kinsta URL on the Domains tab for your site inMyKinsta.
In this example, the temporary URL is example.kinsta.cloud so the URL to the installer file that we need to visit is http://example.kinsta.cloud/installer.php.
On Step 2 of the Duplicator process, ensure that you enter the Database details for your new Kinsta site. You’ll find the Database access details for your Kinsta site on the Info tab for the site inside MyKinsta.
Use the Test Database button to confirm that you have entered the correct Database details on the Duplicator form before proceeding with the restoring by clicking the Next button.
In Step 3 of the Duplicator process, Duplicator will update the database to use the Kinsta temporary URL. This step ensures that you will be able to log in and test the site when the migration is completed. If your existing site is using SSL (HTTPS), please ensure that the temporary URL in the URL field is updated to include https://.
Once the Duplicator process has finished, click the Site Login button to log in to your site.
If everything went OK you should see a message indicating a successful migration upon login.
Cleaning Up the Archive Files
Once you have finished restoring the site on Kinsta, it is recommended that you delete the Duplicator archive and installer files for security purposes. If you’d rather not delete them, you can temporarily move them outside the public/ directory and into the private/ directory. The following files should be deleted or moved out of the public directory:
Previewing Your Site Before Updating DNS
At this point in the migration process, you should be able to browse and test your site on Kinsta using the temporary Kinsta URL (e.g., http://example.kinsta.cloud/).
If you want to test your site using the live domain (e.g., http://example.com/), check out our detailed article on how to Preview Your Site Before Updating DNS.
If Your Site Uses SSL (HTTPS)
If your site is currently using SSL (HTTPS), it’s important to note that it won’t be possible to preview the site over HTTPS using the live domain unless you install a Custom SSL certificate on the Kinsta site.
The second option is to run a search and replace to update the URLs in the database to use http:// so that the site loads over http:// instead of https://. Once you’ve pointed your domain to Kinsta and an SSL certificate has been generated for the site, you’ll need to run a second search and replace to switch the domains back to https://.
When you’re ready to point your domain at Kinsta, you’ll need to update the DNS for your domain to point it at the Kinsta IP address as outlined in our How to Add a Domain to a Site on Kinsta article.
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 and site files were overwritten (including this plugin), 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.