Creating Restore Plans

Creating a File-Level Restore Plan {#creating-a-file-level-backup-plan}

Creating a file-level restore plan in CloudBerry Backup CLI can be done using the addRestorePlan command. The syntax of the command is as follows:

./cbb addRestorePlan -a "S3" -f "/users/robert/Downloads" -ol yes


  • Required parameters:
Parameter Description Value
-a Account name of the target storage String
-f Path of data in the backup storage that should be restored String
-ol Indicates if data should be restored to the original location yes / no

You can get the account names of your target storage by executing the following command:

./cbb account -l
  • Optional parameters:
Parameter Description Value
-n Plans' name String
-sy Sync repository prior to restoration yes / no
-rt Restore type LatestVersion / PointInTime
-pointInTime The version that was the latest at the specified date will be restored. " hh:mm"
-sta User S3 Transfer Acceleration (Amazon only) yes / no
-grt Glacier retrieval rate (Amazon only) Expedited, Standard, Bulk, Skip (don't restore from Glacier)
-vol Restore data from a USB flash drive String
-ep Decryption password String
-se Do not restore existing files yes (default) / no
-de Restore destination. Should only be used if -ol = no String
-notification Indicates if email notifications should be sent upon restore execution / failure on / off / errorOnly
-subject Specifies the subject for email notifications. The following macros are available for subject: %COMPUTER_NAME%, %RESULT%, %PLAN_NAME% String

Scheduling Parameters {#scheduling-parameters}

Scheduling Parameters:

Parameter Description Value
-at Time at which the restoration should be executed " hh:mm" for one-time restoration / "hh:mm" for recurring restoration
-every Recurrence type day / week / month / dayofmonth
-recurrencePeriod Plan recurrence frequency within a period (in minutes) Integer from 0 to 60
-worktime The period for -recurrencePeriod hh:mm-hh:mm
-weekday Days on which restoration will be performed {-every week} String (e.g. "mo, tu, fr, sa")
-day The day on which a monthly restoration is to be performed {-every dayofmonth} Integer from 1 to 31
-weekNumber Specifies the week in which a monthly restoration should be executed First / Second / Third / Fourth / Penultimate / Last
-repeatEvery Recurrence period for monthly restoration Integer from 1 to 12
-repeatFrom Specifies the start date for monthly restoration ""

For example, the following command creates a restore plan entitled Documents that restore data from Amazon S3 one time on March 27, 2018 at 23:00:

./cbb addRestorePlan -a "S3" -n "Documents" -f "/users/robert/Documents" -at "27.03.2018 23:00"

The following command creates a restore plan that is scheduled to execute daily at 9 p.m:

./cbb addRestorePlan -a "My S3 account" -n "Documents" -f "/users/robert/Documents" -every day -at "21:00"

The following command creates a restore plan that is scheduled to execute every Monday, Wednesday, and Friday at 2 a.m:

./cbb addRestorePlan -a "My S3 account" -n "Documents" -f "/users/robert/Documents" -every week -weekday "mo, we, fr" -at "02:00"

The following command creates a restore plan that is scheduled to execute on the first day of every month at 6 a.m. starting from May 1st, 2018:

./cbb addRestorePlan -a "My S3 account" -n "Documents" -f "/users/robert/Documents" -every dayofmonth -day 1 -repeatEvery 1 -repeatFrom "01.05.2018" -at "02:00"

The following command creates a restore plan that is scheduled to execute every 10 minutes:

./cbb addRestorelan -a "My S3 account" -n "Documents" -f "/users/robert/Documents" -every day -recurrencePeriod 10 -worktime "00:00-23:59"

To enable or disable scheduling, execute the following command:

./cbb changePlanState -n "plan's name" -s on/off

All-inclusive Example

The following command creates a backup plan and specifies just about every option available:

./cbb addRestorePlan
-a "My S3 account"
-n "Documents"
-f "/Users/robert/Documents" -f "/Users/robert/Desktop" -f "/Users/robert/Xcode"
-ol no
-de "/Users/robert/restoreHere"
-sy no
-rt pointInTime
-pointInTime "01.01.2018 00:00"
-sta no    
-grt Expedited
-ep "decryptionPassword"
-se no
-notification errorOnly
-subject "Restore Plan: %PLAN_NAME% on %COMPUTER_NAME% executed with status %RESULT%"
-every day -at "21:00"