Creating and Restoring Full Account Backups with cPanel Backup Wizard

Desired Outcome

You need a complete, restorable snapshot of a cPanel account that includes the home directory, MySQL databases, email forwarders and filters. Using the Backup Wizard you can create a .tar.gz file, download it, and later restore the same data to the same or another account.

Prerequisites

1. Logged into cPanel with the Backup feature enabled for your package (WHM → Feature Manager).
2. Sufficient free space in the account’s home directory to hold the temporary backup file (at least the size of the account’s current usage).
3. Optional: Remote FTP, SCP or WebDAV credentials if you prefer to store the backup off‑server.
4. Optional: An email address to receive a completion notice.

Focused Procedure

1. Launch the Backup Wizard

In the cPanel dashboard, locate the Files section and click Backup Wizard.

2. Choose Backup Type

Click Backup, then select Full Backup.

3. Select Destination

• Home Directory – the backup file is placed in /home/username/.
• Remote FTP – enter FTP host, username, password and optional remote directory.
• SCP – provide SCP host, port, username, password or key, and remote path.
• WebDAV – supply WebDAV URL, username and password.

If you choose a remote destination, ensure the account has outbound network access and the remote service allows writes.

4. (Optional) Email Notification

Enter an email address in the Email address field to receive a message when the backup finishes.

5. Generate the Backup

Press Generate Backup. The wizard will create a temporary file, then move it to the chosen destination. Do not navigate away from the page until the status changes to Backup completed.

6. Retrieve the Backup File

If you stored the backup in the home directory, open File Manager, navigate to /home/username/, and locate the file named similar to backup-YYYY-MM-DD-username.tar.gz. Download it via the browser or transfer it off‑server using FTP/SFTP.

Expected Checks

1. Verify the file exists and ends with .tar.gz.
2. Compare its size to the account’s current disk usage shown in cPanel → Statistics → Disk Space Usage. The backup size should be roughly equal or slightly larger due to compression overhead.
3. If you set an email address, confirm receipt of the completion message (check spam folder if needed).
4. Optional integrity test: extract a small portion, e.g., tar -tzf backup-*.tar.gz | head -5 via SSH, to ensure the archive is not corrupted.

Recovery Options

Restoring a Full Backup

1. In cPanel, open Backup Wizard → Restore.
2. Click Choose File and select the previously downloaded .tar.gz archive.
3. Choose what to restore: Home Directory, MySQL Databases, Email Forwarders & Filters, or any combination.
4. Follow the prompts; the system will extract and overwrite existing matching files.
5. When finished, you will see a confirmation screen.

Rollback / Cleanup

Creating a backup adds a file to the home directory (or remote store). If you need to free space after verifying the backup, you can delete the file:

# Run in cPanel Terminal or via SSH with the account’s username
rm /home/username/backup-YYYY-MM-DD-username.tar.gz

Deleting the backup does not affect the live account; it only removes the stored snapshot.

Best Practices

• Perform a test restore of a non‑critical database or a single directory on a sub‑account or development environment before relying on the backup for production recovery.
• Schedule regular backups (e.g., weekly) and retain multiple generations to protect against accidental deletion or corruption.
• Monitor disk quota; if the home directory approaches its limit, the backup will fail with an error about insufficient space.

Limitations

The Backup Wizard does not include system‑level files outside the account’s home directory (e.g., Apache configuration outside public_html) nor does it back up SSL certificates installed via WHM. For those items, use WHM’s backup system or manual copying.