made mktemp a requirement for building backupninja, added autotools variables to...
[matthijs/upstream/backupninja.git] / examples / example.maildir
1 ##
2 ## This is an example maildir configuration file.
3 ##
4 ## The maildir handler slowly creates a backup of each user's
5 ## maildir to a remote server. It is designed to be run with
6 ## low overhead in terms of CPU and bandwidth, so it runs pretty
7 ## slow. Hardlinking is used to save storage space. The actual
8 ## maildir is stored within each snapshot directory.
9 ##
10 ## The basic algorithm is to rsync each maildir individually,
11 ## and to use hard links for retaining historical data.
12 ##
13 ## We handle each maildir individually because it becomes very
14 ## unweldy to hardlink and rsync many hundreds of thousands
15 ## of files at once. It is much faster to take on smaller
16 ## chunks at a time. 
17 ##
18 ## Any maildir which is deleted from the source will be moved to
19 ## "deleted" directory in the destination. It is up to you to 
20 ## periodically remove this directory or old maildirs in it.
21 ##
22 ## Note: This handler assumes that the remote shell is set to bash
23 ##
24 ## The defaults are useful in most cases, just make sure
25 ## to configure the source and destination information
26
27 when = everyday at 21:00
28
29 ## each users maildir will contain these files:
30 ## daily.1, daily.2, daily.3, daily.4, daily.5, weekly.1, weekly.2, 
31 ## weekly.3, monthly.1
32 ## if keepdaily is 5, keepweekly is 3, and keepmonthly is 1
33 keepdaily = 5
34 keepweekly = 3
35 keepmonthly = 1
36
37 # directory which contains all the maildirs
38 srcdir = /maildir/riseup.net
39
40 # the srcdir is expected to contain the following subdirectories. Each
41 # of these will contain the user's Maildirs which start with these
42 # letters
43 srcsubdirs = 0 1 2 3 4 5 6 7 8 9 a b c d e f g h i j k l m n o p q r s t u v w x y z
44
45 # put the backups under this directory
46 destdir = /crypta/maildir/riseup.net
47 desthost = kakapo-pn
48
49 # For the backup rotation to work, destuser must be able to run
50 # arbitrary bash commands on the desthost.
51 destuser = backer
52
53 # remove any maildirs from backup which might have been deleted
54 remove = yes
55
56 # use a ssh-mux to reuse connections, see the following article
57 # http://www.debian-administration.org/articles/290 for an example
58 multiconnection = notset