backupninja/examples/example.rdiff

179 lines
5.6 KiB
Plaintext
Raw Normal View History

2005-10-10 19:35:55 +02:00
##
## This is an example rdiff-backup configuration file.
##
2009-12-25 01:30:11 +01:00
## Here you can find all the possible rdiff-backup options, details of
## 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
## destination host and user.
2005-10-10 19:35:55 +02:00
##
2004-12-09 05:37:12 +01:00
## passed directly to rdiff-backup
## an example setting would be:
## options = --force
2021-01-22 17:24:14 +01:00
##
## Default:
2021-01-22 17:24:14 +01:00
# options =
## default is 0, but set to 19 if you want to lower the priority.
## an example setting would be:
## nicelevel = 19
##
## Default
# nicelevel = 0
## 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 =
## default is yes. set to no to skip the test if the remote host is alive
##
## Default:
# 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)
## an example setting would be:
## bwlimit = 62500
##
## Default:
# bwlimit = 0
2006-12-16 00:13:47 +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
## password-less backups
2021-01-22 17:24:14 +01:00
##
## Default:
# ignore_version = no
## 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]
## an optional subdirectory below 'directory' (see [dest])
2004-12-09 05:37:12 +01:00
label = thishostname
## type can be "local" or "remote"
2004-12-09 05:37:12 +01:00
type = local
## 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:
## 1. include and exclude statements support globbing with '*'
## 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
## files to exclude from the backup
exclude = /home/*/.gnupg
exclude = /var/cache/backupninja/duplicity
2004-12-09 05:37:12 +01:00
######################################################
## destination section
## (where the files are copied to)
[dest]
## 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
##
## 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 =
## 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 =