The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Brackup::Root - describes the source directory (and options) for a backup

EXAMPLE

In your ~/.brackup.conf file:

  [SOURCE:bradhome]
  path = /home/bradfitz/
  gpg_recipient = 5E1B3EC5
  chunk_size = 64MB
  ignore = ^\.thumbnails/
  ignore = ^\.kde/share/thumbnails/
  ignore = ^\.ee/(minis|icons|previews)/
  ignore = ^build/
  noatime = 1

CONFIG OPTIONS

path

The directory to backup (recursively)

gpg_receipient

The public key signature to encrypt data with. See "Using encryption" in Brackup::Manual::Overview.

chunk_size

In units of bytes, kB, MB, etc. The max size of a chunk to be stored on the target. Files over this size are cut up into chunks of this size or smaller. The default is 64 MB if not specified.

ignore

Perl5 regular expression of files not to backup. You may have multiple ignore lines.

noatime

If true, don't backup access times. They're kinda useless anyway, and just make the *.brackup metafiles larger.

merge_files_under

In units of bytes, kB, MB, etc. If files are under this size. By default this feature is off (value 0), purely because it's new, but 1 kB is a recommended size, and will probably be the default in the future. Set it to 0 to explicitly disable.

max_composite_chunk_size

In units of bytes, kB, MB, etc. The maximum size of a composite chunk, holding lots of little files. If this is too big, you'll waste more space with future iterative backups updating files locked into this chunk with unchanged chunks.

Recommended, and default value, is 1 MB.