In your workflow there may be times when you want to clone a duplicate of a site to a new URL, for example:
- If your workflow entails using a development URL during development before transferring to a final production URL when a project is finished.
- You might have a site as a blueprint site that you use as a foundation to work from, including a set of preinstalled themes and plugins with your most common option configurations.
You can use the GridPane single site migration/cloning tool located in the site backups to do this. This tool can be used for cloning a duplicate site to the same server or to another destination server.
This article is for cloning a duplicate site to a different server, if you want to clone a duplicate to the same server we have another KB document for that.
Cloning a duplicate site with a new URL to a different server
Cloning a duplicate site with a new URL to a different server will replicate a near identical state for the new site. The duplicate site will belong to the same owner if that user exists on the server, and it will match all the main control panel settings including:
- WordPress Core
- WordPress Database structure
- System User (this will be created if it doesn’t already exist)
- PHP version and settings
- All General customizer settings including caching
- All Security customizer settings
- Routing (www or none/root)
We will also duplicate your site-specific PHP in settings and PHP process manager settings that GP-CLI manages, alongside the GP-CLI adjusted site-specific Nginx settings and any includes in your site level Nginx directory.
There’s 2 things that don’t currently transfer over when cloning. These are: –
- HTTP Auth
In this article we will be using an example development site
on an origin server called
, to illustrate the steps to migrate this site to a new url of
on a destination server named
(original I know).
Step 0. SSL Preparation (if applicable)
An SSL attempt will be made for the newly cloned site IF SSL is enabled on the original site. For this reason, it is important to make sure that your DNS is resolving correctly for the newly cloned site before you attempt cloning.
If DNS is not resolving the clone will proceed as normal and the SSL attempt will fail and GridPane will ensure that all URLs in the database for the new site are replaced with HTTP variants. You can then manually enable SSL later.
Step 1. Navigate to your Sites page
Click on the Sites link in the GridPane main menu to go to the Sites management page.
Step 2. Open the site customizer
Click on the URL of the site you want to clone a duplicate of in the active site’s panel.
This will open the site customizer.
Step 3. Open the Migrate/Clone tab
Click through to the Clone tab in the site customizer. Here you will find the Migrate/Clone tools:
Step 4. Configure Migrate/Clone for the destination server and new URL duplicate cloning
Here we’ll make use of the second of the two options.
Enter the new URL you’d like to clone your website to and then select the new server from the dropdown list.
Please remember do not enter the URL with the www host included.
Step 5. Click Migrate/Clone Now
Click the Migrate/Clone Now button to start the server process. Your server will begin to clone the duplicate clone site to the destination server immediately.
Please be patient while the duplicate cloning process is ongoing and refrain from making any changes to your site and either the origin server or the destination server.
You will receive a string of notifications to keep you informed about how the migrate/clone is proceeding throughout the process. Please pay attention to these.
When the process is complete your new site will appear in the active sites list.
Your settings on your newly cloned website will match up with your origin site.
Step 6. Check your cloned duplicate site
You should check your duplicate site to make sure everything is as expected. The content and database will have been cloned across and the URLs and file paths will have been updated to the new URL. We will have matched most states for the GridPane features, including all PHP ini settings, PHP process manager settings, and Nginx configuration settings that have been adjusted by GP-CLI. We will also have migrated across cloned files from your Nginx includes directory.
Please ensure that all has cloned correctly before deleting your previous site, and consider keeping the original for 1-2 weeks while backups have time to take place.