2005-10-10 19:35:55 +02:00
|
|
|
##
|
|
|
|
## This is an example rdiff-backup configuration file.
|
2009-08-27 22:53:43 +02:00
|
|
|
##
|
2009-12-25 01:30:11 +01:00
|
|
|
## Here you can find all the possible rdiff-backup options, details of
|
2009-08-27 22:53:43 +02:00
|
|
|
## what the options provide and possible settings. The defaults are set
|
|
|
|
## as the commented out option, uncomment and change when
|
|
|
|
## necessary. Options which are uncommented in this example do not have
|
|
|
|
## defaults, and the settings provided are recommended.
|
2021-01-22 17:24:14 +01:00
|
|
|
##
|
|
|
|
## The defaults are useful in most cases, just make sure to configure the
|
2009-08-27 22:53:43 +02:00
|
|
|
## destination host and user.
|
2005-10-10 19:35:55 +02:00
|
|
|
##
|
2004-12-09 05:37:12 +01:00
|
|
|
|
2005-01-19 20:39:14 +01:00
|
|
|
## passed directly to rdiff-backup
|
2009-08-27 22:53:43 +02:00
|
|
|
## an example setting would be:
|
|
|
|
## options = --force
|
2021-01-22 17:24:14 +01:00
|
|
|
##
|
2009-08-27 22:53:43 +02:00
|
|
|
## Default:
|
2021-01-22 17:24:14 +01:00
|
|
|
# options =
|
2005-01-19 20:39:14 +01:00
|
|
|
|
2005-04-13 07:29:33 +02:00
|
|
|
## default is 0, but set to 19 if you want to lower the priority.
|
2009-08-27 22:53:43 +02:00
|
|
|
## an example setting would be:
|
|
|
|
## nicelevel = 19
|
|
|
|
##
|
|
|
|
## Default
|
|
|
|
# nicelevel = 0
|
2005-04-13 07:29:33 +02:00
|
|
|
|
2020-05-16 18:08:25 +02:00
|
|
|
## ionicelevel is optional. If it is left undefined or empty, ionice will not
|
|
|
|
## be used at all. If it is set to to an integer value from 0 to 7, then ionice
|
|
|
|
## will be used with the best effort class (-c2) and with the ionicelevel as
|
|
|
|
## the class data (-n).
|
|
|
|
##
|
|
|
|
## See the ionice(1) man page for more details about available levels.
|
|
|
|
##
|
|
|
|
## Default:
|
|
|
|
# ionicelevel =
|
|
|
|
|
2005-04-13 07:29:33 +02:00
|
|
|
## default is yes. set to no to skip the test if the remote host is alive
|
2009-08-27 22:53:43 +02:00
|
|
|
##
|
|
|
|
## Default:
|
2005-04-13 07:29:33 +02:00
|
|
|
# testconnect = no
|
|
|
|
|
2021-01-22 17:24:14 +01:00
|
|
|
## default is not to limit bandwidth.
|
|
|
|
## set to a number in bytes/second to limit bandwidth usage. Use a negative
|
|
|
|
## number to set a limit that will never be exceeded, or a positive number
|
|
|
|
## to set a target average bandwidth use. cstream is required. See cstream's
|
2006-12-16 00:13:47 +01:00
|
|
|
## -t option for more information. 62500 bytes = 500 Kb (.5 Mb)
|
2009-08-27 22:53:43 +02:00
|
|
|
## an example setting would be:
|
|
|
|
## bwlimit = 62500
|
|
|
|
##
|
|
|
|
## Default:
|
|
|
|
# bwlimit = 0
|
2006-12-16 00:13:47 +01:00
|
|
|
|
2007-11-02 01:12:04 +01:00
|
|
|
## should backupninja ignore the version differences between source and remote
|
|
|
|
## rdiff-backup? (default: no)
|
|
|
|
## This could be useful if the version differences between rdiff-backup instances
|
|
|
|
## on remote and local side are different, and you are certain there are no
|
|
|
|
## problems in using mis-matched versions and want to get beyond this check.
|
|
|
|
## An example usage could be the remote side has its authorized_keys configured
|
2021-01-22 17:24:14 +01:00
|
|
|
## with command="rdiff-backup --server" to allow for restricted yet automated
|
2007-11-02 01:12:04 +01:00
|
|
|
## password-less backups
|
2021-01-22 17:24:14 +01:00
|
|
|
##
|
2009-08-27 22:53:43 +02:00
|
|
|
## Default:
|
2007-11-02 01:12:04 +01:00
|
|
|
# ignore_version = no
|
|
|
|
|
2013-06-08 08:58:49 +02:00
|
|
|
## should backupninja write program output as Info messages rather than Debug
|
|
|
|
## messages? (default: no)
|
|
|
|
## Usually rdiff-backup output (for increment expiration and backup) is written
|
|
|
|
## to output as Debug messages; this option causes backupninja to use Info-level
|
|
|
|
## messages instead. Since backup reports include Info messages, this option is
|
|
|
|
## useful to receive output like rdiff-backup session statistics in reports. In
|
|
|
|
## addition, since rdiff-backup has a habit of using a zero exit code when
|
|
|
|
## non-fatal errors are encountered (causing backupninja to conclude the backup
|
|
|
|
## was entirely successful), this option is useful for inspecting non-fatal
|
|
|
|
## filesystem and permission errors from rdiff-backup.
|
|
|
|
##
|
|
|
|
## Default:
|
|
|
|
# output_as_info = no
|
|
|
|
|
2004-12-09 05:37:12 +01:00
|
|
|
######################################################
|
|
|
|
## source section
|
|
|
|
## (where the files to be backed up are coming from)
|
|
|
|
|
|
|
|
[source]
|
|
|
|
|
2009-08-27 22:53:43 +02:00
|
|
|
## an optional subdirectory below 'directory' (see [dest])
|
2004-12-09 05:37:12 +01:00
|
|
|
label = thishostname
|
|
|
|
|
2009-08-27 22:53:43 +02:00
|
|
|
## type can be "local" or "remote"
|
2004-12-09 05:37:12 +01:00
|
|
|
type = local
|
|
|
|
|
2009-08-27 22:53:43 +02:00
|
|
|
## only use if '[source] type = remote'
|
|
|
|
# host = srchost
|
|
|
|
# user = srcuser
|
|
|
|
|
|
|
|
## how many days of data to keep
|
|
|
|
## (you can also use the time format of rdiff-backup, e.g. 6D5h)
|
|
|
|
## (to keep everything, set this to yes)
|
|
|
|
## an example setting would be:
|
|
|
|
##keep = yes
|
|
|
|
##
|
|
|
|
## Default:
|
|
|
|
# keep = 60
|
|
|
|
|
|
|
|
## A few notes about includes and excludes:
|
2018-06-29 22:50:41 +02:00
|
|
|
## 1. include and exclude statements support globbing with '*'
|
2009-08-27 22:53:43 +02:00
|
|
|
## 2. Symlinks are not dereferenced. Moreover, an include line whose path
|
|
|
|
## contains, at any level, a symlink to a directory, will only have the
|
|
|
|
## symlink backed-up, not the target directory's content. Yes, you have to
|
|
|
|
## dereference yourself the symlinks, or to use 'mount --bind' instead.
|
|
|
|
## Example: let's say /home is a symlink to /mnt/crypt/home ; the following
|
|
|
|
## line will only backup a "/home" symlink ; neither /home/user nor
|
|
|
|
## /home/user/Mail will be backed-up :
|
|
|
|
## include = /home/user/Mail
|
|
|
|
## A workaround is to 'mount --bind /mnt/crypt/home /home' ; another one is to
|
|
|
|
## write :
|
|
|
|
## include = /mnt/crypt/home/user/Mail
|
|
|
|
## 3. All the excludes come after all the includes. The order is not otherwise
|
|
|
|
## taken into account.
|
|
|
|
|
|
|
|
## files to include in the backup
|
2004-12-09 05:37:12 +01:00
|
|
|
include = /var/spool/cron/crontabs
|
|
|
|
include = /var/backups
|
|
|
|
include = /etc
|
|
|
|
include = /root
|
|
|
|
include = /home
|
|
|
|
include = /usr/local/bin
|
|
|
|
include = /usr/local/sbin
|
|
|
|
include = /var/lib/dpkg/status
|
|
|
|
include = /var/lib/dpkg/status-old
|
|
|
|
|
2009-08-27 22:53:43 +02:00
|
|
|
## files to exclude from the backup
|
|
|
|
exclude = /home/*/.gnupg
|
2010-05-10 22:18:49 +02:00
|
|
|
exclude = /var/cache/backupninja/duplicity
|
2004-12-09 05:37:12 +01:00
|
|
|
|
|
|
|
######################################################
|
|
|
|
## destination section
|
|
|
|
## (where the files are copied to)
|
|
|
|
|
|
|
|
[dest]
|
|
|
|
|
2009-08-27 22:53:43 +02:00
|
|
|
## type can be "local" or "remote", this must be set!
|
|
|
|
## an example configuration would be:
|
|
|
|
## type = remote
|
|
|
|
##
|
|
|
|
## Default:
|
|
|
|
# type =
|
|
|
|
|
|
|
|
## put the backups under this directory, this must be set!
|
|
|
|
## an example setting would be:
|
|
|
|
## directory = /backups
|
2021-01-22 17:24:14 +01:00
|
|
|
##
|
2009-08-27 22:53:43 +02:00
|
|
|
## Default:
|
|
|
|
# directory =
|
|
|
|
|
|
|
|
## the machine which will receive the backups.
|
|
|
|
## only use if "[dest] type = remote"
|
|
|
|
## an example setting would be:
|
|
|
|
## host = backuphost
|
|
|
|
##
|
|
|
|
## Default
|
|
|
|
# host =
|
|
|
|
|
|
|
|
## make the files owned by this user. you must be able to
|
|
|
|
## `su -c "ssh backupuser@backhost"` without specifying a password.
|
|
|
|
## only use if "[dest] type = remote"
|
|
|
|
## an example setting would be:
|
|
|
|
## user = backupuser
|
|
|
|
##
|
|
|
|
## Default:
|
|
|
|
# user =
|
2005-04-13 07:29:33 +02:00
|
|
|
|
2011-04-26 12:31:58 +02:00
|
|
|
## passed directly to ssh
|
|
|
|
## an example setting would be:
|
|
|
|
## sshoptions = -o IdentityFile=/root/.ssh/id_rsa_duplicity
|
|
|
|
##
|
|
|
|
## Default:
|
2021-01-22 17:24:14 +01:00
|
|
|
# sshoptions =
|