1restic backup(1) restic backup(1)
2
3
4
6 restic-backup - Create a new backup of files and/or directories
7
8
9
11 restic backup [flags] FILE/DIR [FILE/DIR] ...
12
13
14
16 The "backup" command creates a new snapshot and saves the files and
17 directories given as the arguments.
18
19
20
22 -e, --exclude=[]
23 exclude a pattern (can be specified multiple times)
24
25
26 --exclude-caches[=false]
27 excludes cache directories that are marked with a CACHEDIR.TAG
28 file. See ⟨http://bford.info/cachedir/spec.html⟩ for the Cache
29 Directory Tagging Standard
30
31
32 --exclude-file=[]
33 read exclude patterns from a file (can be specified multiple times)
34
35
36 --exclude-if-present=[]
37 takes filename[:header], exclude contents of directories containing
38 filename (except filename itself) if header of that file is as provided
39 (can be specified multiple times)
40
41
42 --files-from=[]
43 read the files to backup from file (can be combined with file
44 args/can be specified multiple times)
45
46
47 -f, --force[=false]
48 force re-reading the target files/directories (overrides the
49 "parent" flag)
50
51
52 -h, --help[=false]
53 help for backup
54
55
56 -H, --host=""
57 set the hostname for the snapshot manually. To prevent an expensive
58 rescan use the "parent" flag
59
60
61 --iexclude=[]
62 same as --exclude but ignores the casing of filenames
63
64
65 --ignore-inode[=false]
66 ignore inode number changes when checking for modified files
67
68
69 -x, --one-file-system[=false]
70 exclude other file systems
71
72
73 --parent=""
74 use this parent snapshot (default: last snapshot in the repo that
75 has the same target files/directories)
76
77
78 --stdin[=false]
79 read backup from stdin
80
81
82 --stdin-filename="stdin"
83 file name to use when reading from stdin
84
85
86 --tag=[]
87 add a tag for the new snapshot (can be specified multiple times)
88
89
90 --time=""
91 time of the backup (ex. '2012-11-01 22:08:41') (default: now)
92
93
94 --with-atime[=false]
95 store the atime for all files and directories
96
97
98
100 --cacert=[]
101 file to load root certificates from (default: use system
102 certificates)
103
104
105 --cache-dir=""
106 set the cache directory. (default: use system default cache
107 directory)
108
109
110 --cleanup-cache[=false]
111 auto remove old cache directories
112
113
114 --json[=false]
115 set output mode to JSON for commands that support it
116
117
118 --key-hint=""
119 key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
120
121
122 --limit-download=0
123 limits downloads to a maximum rate in KiB/s. (default: unlimited)
124
125
126 --limit-upload=0
127 limits uploads to a maximum rate in KiB/s. (default: unlimited)
128
129
130 --no-cache[=false]
131 do not use a local cache
132
133
134 --no-lock[=false]
135 do not lock the repo, this allows some operations on read-only
136 repos
137
138
139 -o, --option=[]
140 set extended option (key=value, can be specified multiple times)
141
142
143 --password-command=""
144 specify a shell command to obtain a password (default:
145 $RESTIC_PASSWORD_COMMAND)
146
147
148 -p, --password-file=""
149 read the repository password from a file (default:
150 $RESTIC_PASSWORD_FILE)
151
152
153 -q, --quiet[=false]
154 do not output comprehensive progress report
155
156
157 -r, --repo=""
158 repository to backup to or restore from (default:
159 $RESTIC_REPOSITORY)
160
161
162 --tls-client-cert=""
163 path to a file containing PEM encoded TLS client certificate and
164 private key
165
166
167 -v, --verbose[=0]
168 be verbose (specify --verbose multiple times or level n)
169
170
171
173 restic(1)
174
175
176
177generated by `restic generate` Jan 2017 restic backup(1)