Skip to main content

Easy and configurable backup tool

Project description

A simple backup utility. Configurable with a YAML file.

See ./ -h for command usage.


sudo ./ install
# or, to install it for the user
./ install --user

Configuration reference

Minimal backupfile.yml

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


  • 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.


  • 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.


  • 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:

    most_recents: 2
    first_daily: 1
    first_weekly: 6
    first_monthly: 4
such design wow

Backup management schema

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.


  • Definition : number of recent backups to keep (in addition to the current one).
  • Type : natural integer.
  • Mandatory : no.
  • Default value : 0.


  • Definition : number of daily backups to keep (keeps the n first backups of the current day).
  • Type : natural integer.
  • Mandatory : no.
  • Default value : 0.


  • Definition : number of weekly backups to keep (keeps the n first backups of the current week).
  • Type : natural integer.
  • Mandatory : no.
  • Default value : 0.


  • Definition : number of monthly backups to keep (keeps the n first backups of the current month).
  • Type : natural integer.
  • Mandatory : no.
  • Default value : 0.


  • Definition : specifies a list of files and folders to backup.
  • Type : a list of absolute or relative paths.
  • Mandatory : yes.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for backupper, version 0.1a3
Filename, size File type Python version Upload date Hashes
Filename, size backupper-0.1a3-py2.py3-none-any.whl (8.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size backupper-0.1a3.tar.gz (28.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page