We have a new documentation site for cPanel & WHM! You can find our new documentation site at docs.cpanel.net.

We will continue to maintain our API documentation on this server.

Child pages
  • Remote Restoration
For cPanel & WHM version 74

Skip to end of metadata
Go to start of metadata



For this feature to work, you must enable account backups in WHM's Backup Configuration interface (WHM >> Home >> Backup >> Backup Configuration).

WHM's Backup Configuration interface (Home >> Backup >> Backup Configuration) allows you and your users to store backup files in locations that you configured with the Additional Destinations option. This includes the following destinations:

  • Amazon S3™
  • FTP
  • Google Drive™
  • S3 Compatible
  • SFTP
  • WebDAV
  • A local directory
  • Custom locations

To restore backups from these locations, users must transfer the backup file to their servers before they can restore the backups.

How to transfer the backup file


You must manually transfer the backup files from the remote location to your server. However, after you transfer the backup files to the server, WHM's Backup Restoration feature (WHM >> Home >> Backup >> Backup Restoration) handles the actual restoration.


To transfer a backup file from a remote location to your server, perform the following steps:

  1. Use your preferred tool to access the additional destination that you created with the Additional Destinations option in WHM's Backup Configuration interface (WHM >> Home >> Backup >> Backup Restoration). For example, you can use an FTP client to access an FTP destination.
  2. Locate your desired backup files and transfer them to your local computer.
  3. Place the backup files in the appropriate backup directory on your server.


    The backup directory's on your server will resemble the BACKUPDIR/date/accounts format, where:

    • BACKUPDIR is the variable from the /var/cpanel/backups/config file.
    • date is in yyyy-mm-dd format, where yyyy is the four-digit year, mm is the month, and dd is the day of the month.

The backup files will now appear in WHM's Backup Restoration interface (WHM >> Home >> Backup >> Backup Restoration) under the appropriate account and date.

Additional documentation

There is no content with the specified labels

There is no content with the specified labels

There is no content with the specified labels