Database Backups - Revision history

Lawrence: /* cPanel Backup */

2023-10-18T14:35:11Z

‎cPanel Backup

John: /* cPanel Username */

2023-01-27T10:06:18Z

‎cPanel Username

SarahK: /* cPanel Backup */

2022-04-21T18:36:43Z

‎cPanel Backup

SarahK at 21:08, 14 April 2022

2022-04-14T21:08:58Z

SarahK: Created page with "Regular backups help to protect your customer data and WHMCS configuration, and they are vital if you run into certain prolems. WHMCS can automatically back up your database a..."

2022-01-19T18:35:18Z

Created page with "Regular backups help to protect your customer data and WHMCS configuration, and they are vital if you run into certain prolems. WHMCS can automatically back up your database a..."

New page

Regular backups help to protect your customer data and WHMCS configuration, and they are vital if you run into certain prolems. WHMCS can automatically back up your database and upload it to a SFTP/FTP location or email it to a designated email address. You can also request a full cPanel backup for a specific user as part of the automatic backup process.

You can configure automated database backups at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Database Backups'''.

<div class="docs-alert-info"><i class="fa fa-info"></i> We added automated backups in WHMCS 7.3.</div>

==Enable Automatic Backups==

To enable automatic backups for your WHMCS installation:

# Choose a backup option by clicking the correct heading: '''SFTP/FTP Backup''', '''cPanel Backup''', or '''Daily Email Backups'''.<div class="docs-alert-warning"><span class="title">Connection Tests</span><br />The '''SFTP/FTP Backup''' and '''cPanel Backup''' options require a successful connection test before activation. A connection test ensures that the details are valid and the WHMCS installation can connect to the server. Any connection issue allows a resolution before a backup attempt occurs, incurring less chance of a failed connection.</div>
# Enter the necessary informaton for that option. For more information on each option, see the sections below.
# Click '''Test Connection''' or '''Save & Activate'''.

===SFTP/FTP Backup===

The '''SFTP/FTP Backup''' option only supports FTP and SFTP. Other protocols, like FTPS and FTP/TLD, are unsupported.

This backup type stores the WHMCS-generated zipped SQL file on the specified remote server. Check "'Use Secure FTP/SFTP (Recommended)'" to ensure that the backup upload is completed using an SFTP connection.

====FTP Destination====

The '''FTP Destination''' value is relative to the login folder for the FTP/SFTP account you are using. For example, if, when you log in using your FTP details, the folder is <tt>/home/user/</tt> and the backup will be in <tt>/home/user/backups</tt>, enter <tt>backups/</tt> as the '''FTP Destination''' value.

If you intend to upload the backup file to the login folder, leave this field empty.

===cPanel Backup===

The '''cPanel Backup''' option uses the '''Full Backup''' feature of cPanel's '''[https://docs.cpanel.net/cpanel/files/backup-wizard/ Backup Wizard]]''' interface.

====cPanel Username====

When you enter your cPanel account information, the '''cPanel Username''' value is the name of the account that hosts your WHMCS installation.</div>

====Backup Destination====

You can select the following '''Backup Destination''' options:

* '''Remote FTP Server''' — Select this option to use FTP to store the backup file on a remote server.
* '''Remote FTP Server (Passive connection)''' — Select this option to use passive FTP to store the backup file on a remote server.
* '''Secure Copy (SCP)''' — Select this option to use SCP to store the backup file on a remote server.
* '''Home Directory''' — Select this option to save the backup file to the server.

<div class="docs-alert-warning"><i class="fa fa-exclamation-triangle"></i>Using '''Home Directory''' will generate the backup file in the cPanel user's home directory. This will count against any disk space limits, and you should manually move it to a better location after completion.</div>

The system cron job will only request the start of a full backup. Completion and relocation of the backup occurs within cPanel, and WHMCS will not notify you about the process.

===Daily Email Backups===

This backup option may fail to complete successfully with large databases due to system memory or time execution limits. We do not recommend this method for larger installations.

==Disable Automatic Backups==

To disable an automatic backup method:

# Click on that option.
# Click '''Deactivate'''.

@@ Line 29: / Line 29: @@
 ===cPanel Backup===
-The '''cPanel Backup''' option uses the '''Full Backup''' feature of cPanel's '''[https://docs.cpanel.net/cpanel/files/backup-wizard/ Backup Wizard]''' interface.
+The '''cPanel Backup''' option uses the backup API functions that cPanel & WHM provides to generate backups using an API token.
 ====cPanel Username====

@@ Line 33: / Line 33: @@
 ====cPanel Username====
-When you enter your cPanel account information, the '''cPanel Username''' value is the name of the account that hosts your WHMCS installation.</div>
+When you enter your cPanel account information, the '''cPanel Username''' value is the name of the account that hosts your WHMCS installation.
 ====Backup Destination====

@@ Line 1: / Line 1: @@
 Regular backups help to protect your customer data and WHMCS configuration, and they are vital if you run into certain prolems. WHMCS can automatically back up your database and upload it to a SFTP/FTP location or email it to a designated email address. You can also request a full cPanel backup for a specific user as part of the automatic backup process.
-You can configure automated database backups at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Database Backups'''.
+You can access this feature at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Database Backups'''.
-<div class="docs-alert-info"><i class="fa fa-info"></i> We added automated backups in WHMCS 7.3.</div>
+<div class="docs-alert-info">
 ==Enable Automatic Backups==