1restic backup(1) restic backup(1)
2
6 restic-backup - Create a new backup of files and/or directories
7
11 restic backup [flags] [FILE/DIR] ...
12
16 The "backup" command creates a new snapshot and saves the files and di‐
17 rectories given as the arguments.
18
22 Exit status is 0 if the command was successful. Exit status is 1 if
23 there was a fatal error (no snapshot created). Exit status is 3 if
24 some source data could not be read (incomplete snapshot created).
25
29 -n, --dry-run[=false] do not upload or write any data, just show
30 what would be done
31 -e, --exclude=[] exclude a pattern (can be specified multiple
34 times)
35 --exclude-caches[=false] excludes cache directories that are
38 marked with a CACHEDIR.TAG file. See https://bford.info/cachedir/ for
39 the Cache Directory Tagging Standard
40 --exclude-file=[] read exclude patterns from a file (can be speci‐
43 fied multiple times)
44 --exclude-if-present=[] takes filename[:header], exclude contents
47 of directories containing filename (except filename itself) if header
48 of that file is as provided (can be specified multiple times)
49 --exclude-larger-than="" max size of the files to be backed up
52 (allowed suffixes: k/K, m/M, g/G, t/T)
53 --files-from=[] read the files to backup from file (can be com‐
56 bined with file args; can be specified multiple times)
57 --files-from-raw=[] read the files to backup from file (can be
60 combined with file args; can be specified multiple times)
61 --files-from-verbatim=[] read the files to backup from file (can
64 be combined with file args; can be specified multiple times)
65 -f, --force[=false] force re-reading the target files/directories
68 (overrides the "parent" flag)
69 -h, --help[=false] help for backup
72 -H, --host="" set the hostname for the snapshot manually. To pre‐
75 vent an expensive rescan use the "parent" flag
76 --iexclude=[] same as --exclude pattern but ignores the casing of
79 filenames
80 --iexclude-file=[] same as --exclude-file but ignores casing of
83 filenames in patterns
84 --ignore-ctime[=false] ignore ctime changes when checking for mod‐
87 ified files
88 --ignore-inode[=false] ignore inode number changes when checking
91 for modified files
92 -x, --one-file-system[=false] exclude other file systems, don't
95 cross filesystem boundaries and subvolumes
96 --parent="" use this parent snapshot (default: last snapshot in
99 the repository that has the same target files/directories, and is not
100 newer than the snapshot time)
101 --stdin[=false] read backup from stdin
104 --stdin-filename="stdin" filename to use when reading from stdin
107 --tag=[] add tags for the new snapshot in the format tag[,tag,...]
110 (can be specified multiple times)
111 --time="" time of the backup (ex. '2012-11-01 22:08:41') (default:
114 now)
115 --with-atime[=false] store the atime for all files and directories
118
122 --cacert=[] file to load root certificates from (default: use sys‐
123 tem certificates)
124 --cache-dir="" set the cache directory. (default: use system de‐
127 fault cache directory)
128 --cleanup-cache[=false] auto remove old cache directories
131 --compression=auto compression mode (only available for repository
134 format version 2), one of (auto|off|max)
135 --insecure-tls[=false] skip TLS certificate verification when con‐
138 necting to the repository (insecure)
139 --json[=false] set output mode to JSON for commands that support
142 it
143 --key-hint="" key ID of key to try decrypting first (default:
146 $RESTIC_KEY_HINT)
147 --limit-download=0 limits downloads to a maximum rate in KiB/s.
150 (default: unlimited)
151 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
154 fault: unlimited)
155 --no-cache[=false] do not use a local cache
158 --no-lock[=false] do not lock the repository, this allows some op‐
161 erations on read-only repositories
162 -o, --option=[] set extended option (key=value, can be specified
165 multiple times)
166 --pack-size=0 set target pack size in MiB, created pack files may
169 be larger (default: $RESTIC_PACK_SIZE)
170 --password-command="" shell command to obtain the repository pass‐
173 word from (default: $RESTIC_PASSWORD_COMMAND)
174 -p, --password-file="" file to read the repository password from
177 (default: $RESTIC_PASSWORD_FILE)
178 -q, --quiet[=false] do not output comprehensive progress report
181 -r, --repo="" repository to backup to or restore from (default:
184 $RESTIC_REPOSITORY)
185 --repository-file="" file to read the repository location from
188 (default: $RESTIC_REPOSITORY_FILE)
189 --tls-client-cert="" path to a file containing PEM encoded TLS
192 client certificate and private key
193 -v, --verbose[=0] be verbose (specify multiple times or a level
196 using --verbose=n, max level/times is 3)
197
201 restic(1)
202generated by restic generate Jan 2017 restic backup(1)