1 `bwlimit`: `<integer> (0 - N)` ('default =' `0`)::
3 Limit I/O bandwidth (KBytes per second).
5 `compress`: `<0 | 1 | gzip | lzo | zstd>` ('default =' `0`)::
9 `dumpdir`: `<string>` ::
11 Store resulting files to specified directory.
13 `exclude-path`: `<string>` ::
15 Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.
17 `ionice`: `<integer> (0 - 8)` ('default =' `7`)::
19 Set CFQ ionice priority.
21 `lockwait`: `<integer> (0 - N)` ('default =' `180`)::
23 Maximal time to wait for the global lock (minutes).
25 `mailnotification`: `<always | failure>` ('default =' `always`)::
27 Specify when to send an email
29 `mailto`: `<string>` ::
31 Comma-separated list of email addresses or users that should receive email notifications.
33 `maxfiles`: `<integer> (1 - N)` ::
35 Deprecated: use 'prune-backups' instead. Maximal number of backup files per guest system.
37 `mode`: `<snapshot | stop | suspend>` ('default =' `snapshot`)::
41 `notes-template`: `<string>` ::
43 Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are \{\{cluster\}\}, \{\{guestname\}\}, \{\{node\}\}, and \{\{vmid\}\}, but more might be added in the future. Needs to be a single line, newline and backslash need to be escaped as '\n' and '\\' respectively.
45 NOTE: Requires option(s): `storage`
47 `performance`: `[max-workers=<integer>]` ::
49 Other performance-related settings.
51 `max-workers`=`<integer> (1 - 256)` ('default =' `16`);;
53 Applies to VMs. Allow up to this many IO workers at the same time.
55 `pigz`: `<integer>` ('default =' `0`)::
57 Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.
61 Backup all known guest systems included in the specified pool.
63 `protected`: `<boolean>` ::
65 If true, mark backup(s) as protected.
67 NOTE: Requires option(s): `storage`
69 `prune-backups`: `[keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]` ('default =' `keep-all=1`)::
71 Use these retention options instead of those from the storage configuration.
73 `keep-all`=`<boolean>` ;;
75 Keep all backups. Conflicts with the other options when true.
79 Keep backups for the last <N> different days. If there is morethan one backup for a single day, only the latest one is kept.
81 `keep-hourly`=`<N>` ;;
83 Keep backups for the last <N> different hours. If there is morethan one backup for a single hour, only the latest one is kept.
87 Keep the last <N> backups.
89 `keep-monthly`=`<N>` ;;
91 Keep backups for the last <N> different months. If there is morethan one backup for a single month, only the latest one is kept.
93 `keep-weekly`=`<N>` ;;
95 Keep backups for the last <N> different weeks. If there is morethan one backup for a single week, only the latest one is kept.
97 `keep-yearly`=`<N>` ;;
99 Keep backups for the last <N> different years. If there is morethan one backup for a single year, only the latest one is kept.
101 `remove`: `<boolean>` ('default =' `1`)::
103 Prune older backups according to 'prune-backups'.
105 `script`: `<string>` ::
107 Use specified hook script.
109 `stdexcludes`: `<boolean>` ('default =' `1`)::
111 Exclude temporary files and logs.
113 `stopwait`: `<integer> (0 - N)` ('default =' `10`)::
115 Maximal time to wait until a guest system is stopped (minutes).
117 `storage`: `<string>` ::
119 Store resulting file to this storage.
121 `tmpdir`: `<string>` ::
123 Store temporary files to specified directory.
125 `zstd`: `<integer>` ('default =' `1`)::
127 Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.