1restic backup(1) restic backup(1)
2
3
4
6 restic-restore - Extract the data from a snapshot
7
8
9
11 restic restore [flags] snapshotID
12
13
14
16 The "restore" command extracts the data from a snapshot from the repos‐
17 itory to a directory.
18
19
20 The special snapshot "latest" can be used to restore the latest snap‐
21 shot in the repository.
22
23
24
26 Exit status is 0 if the command was successful, and non-zero if there
27 was any error.
28
29
30
32 -e, --exclude=[] exclude a pattern (can be specified multiple
33 times)
34
35
36 -h, --help[=false] help for restore
37
38
39 -H, --host=[] only consider snapshots for this host, when snapshot
40 ID "latest" is given (can be specified multiple times)
41
42
43 --iexclude=[] same as --exclude but ignores the casing of file‐
44 names
45
46
47 --iinclude=[] same as --include but ignores the casing of file‐
48 names
49
50
51 -i, --include=[] include a pattern, exclude everything else (can
52 be specified multiple times)
53
54
55 --path=[] only consider snapshots including this (absolute) path,
56 when snapshot ID "latest" is given (can be specified multiple times)
57
58
59 --sparse[=false] restore files as sparse
60
61
62 --tag=[] only consider snapshots including tag[,tag,...], when
63 snapshot ID "latest" is given (can be specified multiple times)
64
65
66 -t, --target="" directory to extract data to
67
68
69 --verify[=false] verify restored files content
70
71
72
74 --cacert=[] file to load root certificates from (default: use sys‐
75 tem certificates)
76
77
78 --cache-dir="" set the cache directory. (default: use system de‐
79 fault cache directory)
80
81
82 --cleanup-cache[=false] auto remove old cache directories
83
84
85 --compression=auto compression mode (only available for repository
86 format version 2), one of (auto|off|max)
87
88
89 --insecure-tls[=false] skip TLS certificate verification when con‐
90 necting to the repository (insecure)
91
92
93 --json[=false] set output mode to JSON for commands that support
94 it
95
96
97 --key-hint="" key ID of key to try decrypting first (default:
98 $RESTIC_KEY_HINT)
99
100
101 --limit-download=0 limits downloads to a maximum rate in KiB/s.
102 (default: unlimited)
103
104
105 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
106 fault: unlimited)
107
108
109 --no-cache[=false] do not use a local cache
110
111
112 --no-lock[=false] do not lock the repository, this allows some op‐
113 erations on read-only repositories
114
115
116 -o, --option=[] set extended option (key=value, can be specified
117 multiple times)
118
119
120 --pack-size=0 set target pack size in MiB, created pack files may
121 be larger (default: $RESTIC_PACK_SIZE)
122
123
124 --password-command="" shell command to obtain the repository pass‐
125 word from (default: $RESTIC_PASSWORD_COMMAND)
126
127
128 -p, --password-file="" file to read the repository password from
129 (default: $RESTIC_PASSWORD_FILE)
130
131
132 -q, --quiet[=false] do not output comprehensive progress report
133
134
135 -r, --repo="" repository to backup to or restore from (default:
136 $RESTIC_REPOSITORY)
137
138
139 --repository-file="" file to read the repository location from
140 (default: $RESTIC_REPOSITORY_FILE)
141
142
143 --tls-client-cert="" path to a file containing PEM encoded TLS
144 client certificate and private key
145
146
147 -v, --verbose[=0] be verbose (specify multiple times or a level
148 using --verbose=n``, max level/times is 2)
149
150
151
153 restic(1)
154
155
156
157generated by restic generate Jan 2017 restic backup(1)