How to run cPanel accounts backup from SSH

It’s always a good idea to make on-site/off-site backups of your cPanel accounts. WHM will automatically make backups as per settings from WHM->Backup->Backup Configuration. But you can also run the backup process from the command line.

To start the backup, run:


and to force it, run:

/usr/local/cpanel/bin/backup --force

Notice that if backups are not enabled in WHM you can’t start the backup process with the first command:

root@web [~]# /usr/local/cpanel/bin/backup
[2017-05-30 13:13:11 -0400] info [backup] Started at Tue May 30 13:13:11 2017
[2017-05-30 13:13:11 -0400] info [backup] Backups are not scheduled to run today. This can be adjusted in WHM => Backup => Backup Configuration or by calling bin/backup with the --force argument.

You will need to use the –force argument:

root@web [~]# /usr/local/cpanel/bin/backup --force
[2017-05-30 13:15:21 -0400] info [backup] Started at Tue May 30 13:15:21 2017
[2017-05-30 13:15:22 -0400] info [backup] The backup is now running in the background in process 16608.
[2017-05-30 13:15:22 -0400] info [backup] The backup process’s log file is "/usr/local/cpanel/logs/cpbackup/1496164521.log".

Don’t forget to select the users for which you will run the backup. Select them in WHM->Backup->Backup User Selection

For some time you can also use the old backup (legacy) system. Notice that it will be removed in the next cPanel versions – probably in v66. To start the old backup process:


and to force the legacy backup to start, use:

/usr/local/cpanel/scripts/cpbackup --force

You will use the –force parameter if the backup is up to date but you still want to run it for any reason.

Leave a Reply