WPCloudDeploy Documentation

Restoring From Backup

Verify Backup Files Are On The Server

Before you can restore from backup, the backup files must be present on the server.

You can see which backup files are on the server using the REFRESH button in the backup tab:

  • Go to WPCLOUDDEPLOY → ALL APPS and click on the site that needs to be restored
  • Click on the BACKUP & RESTORE tab
  • Scroll down to the RESTORES section
  • Click on the REFRESH BACKUP LIST button.

If the backup you’re looking for is not there but is located on the AWS S3 (or compatible) service you will need to move the files onto the server – see the BACKUP FILE LOCATIONS section later below.

Restore Your Site

Now that you’ve verified that the backup files are present on the server, restoring is simple.  You have three restore options:

  • RESTORE SELECTED BACKUP – this restores everything (files, database etc.)
  • RESTORE WEB SERVER CONFIGURATION – only restores the web server configuration files
  • RESTORE WP-CONFIG.PHP FILE – restores only the WordPress wp-config.php file

Select a backup from the drop-down and use one of the restore buttons – most often you’ll use RESTORE SELECTED BACKUP to restore everything.

The restore process should throw output similar to the following:

Backup File Locations

If your backup files are not located on the server, you can upload them using sFTP.

But first, you need to make sure that the backup folders exist for the domain (especially if you’re restoring to a new server).

Log into server via ssh (sudo or root login)

Check to see if a folder called .wp-backup exists

sudo ls ~/.wp-backup

If not, make one:

sudo mkdir ~/.wp-backup

Then, check to see if a folder with the domain name exists:

sudo ls ~/.wp-backup/yourdomain

If it does not, make one:

sudo mkdir ~/.wp-backup/yourdomain

Note: Replace yourdomain in the commands above with your actual domain.  For example, if your actual domain is ems01.vnxv.com then your commands will be:

sudo ls ~/.wp-backup/ems01.vnxv.com
sudo mkdir ~/.wp-backup/ems01.vnxv.com

Now, you can use any sFTP tool to upload the backup files to the ~/.wp-backup/yourdomain folder.

Notes

  • You cannot restore sites between different Web Servers – in other words, if you backed up a site running under NGINX, you cannot restore it into a server using the OpenLiteSpeed webserver.
  • The site will be restored to the server and database name in the wp-config.php file that was part of the backup.  This has some implications.  For example, if you have switched your database to use a remote database but are now trying to restore a backup taken when the database was a localhost database, the restore will attempt to restore to localhost; and, if successful, your site will now be running on localhost instead of using the remote database server you had been using before the restore!
  • If you need to restore a site to a new server, check out this document: Restoring from AWS S3 Into A New Site or Server.
  • We’re aware of an OLS issue where the WPCD UI might show the incorrect version of PHP after a restore.  The issue arises if you restore a site that was running on a version of PHP that is not 8.1.  Then, the site is restored using that version but the UI will still show PHP 8.1  The fix is easy – just switch the PHP version in the WPCD UI to show the correct version after the restore.

 

Share: