Minimal backupfile.yml

backup_dir: /backup/root
artifacts:
    - a/file
    - a/directory
    - /another/directory/
    - et/caetera

backup_dir

• Definition: specifies the folder in which the backup directory will be created. If the folder doesn’t exist, it will be created.

• Type: relative or absolute path.

• Mandatory: no, unless delete_old_backups is set to true.

• Default value: current working directory.

delete_old_backups

• Definition: allows you to delete old backups from the backup directory specified in backup_dir. If cleaning_policy isn’t set, all previous backups will be deleted.

• Type: boolean.

• Mandatory: no.

• Default value: false.

cleaning_policy

• Definition: allows you to define a fine-tuned deletion policy. Will do nothing if delete_old_backups is set to false.

• Type: at least one of the following parameters.

• Mandatory: no (if not set, all older backups will be deleted).

Each parameter below can be set (at least one). The following schema visually presents how they work, assuming this cleaning policy:

cleaning_policy:
    most_recents: 2
    first_daily: 1
    first_weekly: 6
    first_monthly: 4

N.B.: please keep in mind that if you increase one of the parameters between two backups, deleted backups won’t magically pop back from nowhere. We strongly advise you to be careful with these values.

encrypt

• Definition: specifies if the backup should be encrypted. Encryption is performed with GnuPG, so make sure it’s properly installed on your system.

• Type: boolean.

• Mandatory: no.

• Default value: false.

gnupg

• Definition: GnuPG configuration.

• Type: a list of the following parameters.

• Mandatory: yes, if encrypt is set to true.

artifacts

• Definition: specifies a list of files and folders to backup.

• Type: a list of absolute or relative paths.

• Mandatory: yes.