restic-restore(1)

1restic backup(1)                                              restic backup(1)
2
3
4

NAME

6       restic-restore - Extract the data from a snapshot
7
8
9

SYNOPSIS

11       restic restore [flags] snapshotID
12
13
14

DESCRIPTION

16       The "restore" command extracts the data from a snapshot from the repos‐
17       itory to a directory.
18
19
20       The special snapshotID "latest" can be used to restore the latest snap‐
21       shot in the repository.
22
23
24       To only restore a specific subfolder, you can use the ":" syntax, where
25       "subfolder" is a path within the snapshot.
26
27
28

EXIT STATUS

30       Exit status is 0 if the command was successful, and non-zero  if  there
31       was any error.
32
33
34

OPTIONS

36       -e,  --exclude=[]       exclude  a  pattern  (can be specified multiple
37       times)
38
39
40       -h, --help[=false]      help for restore
41
42
43       -H, --host=[]      only consider snapshots for this host, when snapshot
44       ID "latest" is given (can be specified multiple times)
45
46
47       --iexclude=[]      same as --exclude but ignores the casing of pattern
48
49
50       --iinclude=[]      same as --include but ignores the casing of pattern
51
52
53       -i,  --include=[]       include a pattern, exclude everything else (can
54       be specified multiple times)
55
56
57       --path=[]      only consider snapshots including this (absolute)  path,
58       when snapshot ID "latest" is given (can be specified multiple times)
59
60
61       --sparse[=false]      restore files as sparse
62
63
64       --tag=[]       only  consider  snapshots  including tag[,tag,...], when
65       snapshot ID "latest" is given (can be specified multiple times)
66
67
68       -t, --target=""      directory to extract data to
69
70
71       --verify[=false]      verify restored files content
72
73
74

OPTIONS INHERITED FROM PARENT COMMANDS

76       --cacert=[]      file to load root certificates from (default: use sys‐
77       tem certificates or $RESTIC_CACERT)
78
79
80       --cache-dir=""       set  the cache directory. (default: use system de‐
81       fault cache directory)
82
83
84       --cleanup-cache[=false]      auto remove old cache directories
85
86
87       --compression=auto      compression mode (only available for repository
88       format version 2), one of (auto|off|max) (default: $RESTIC_COMPRESSION)
89
90
91       --insecure-tls[=false]      skip TLS certificate verification when con‐
92       necting to the repository (insecure)
93
94
95       --json[=false]      set output mode to JSON for commands  that  support
96       it
97
98
99       --key-hint=""       key  ID  of  key  to try decrypting first (default:
100       $RESTIC_KEY_HINT)
101
102
103       --limit-download=0      limits downloads to a maximum  rate  in  KiB/s.
104       (default: unlimited)
105
106
107       --limit-upload=0       limits  uploads to a maximum rate in KiB/s. (de‐
108       fault: unlimited)
109
110
111       --no-cache[=false]      do not use a local cache
112
113
114       --no-lock[=false]      do not lock the repository, this allows some op‐
115       erations on read-only repositories
116
117
118       -o,  --option=[]       set extended option (key=value, can be specified
119       multiple times)
120
121
122       --pack-size=0      set target pack size in MiB, created pack files  may
123       be larger (default: $RESTIC_PACK_SIZE)
124
125
126       --password-command=""      shell command to obtain the repository pass‐
127       word from (default: $RESTIC_PASSWORD_COMMAND)
128
129
130       -p, --password-file=""      file to read the repository  password  from
131       (default: $RESTIC_PASSWORD_FILE)
132
133
134       -q, --quiet[=false]      do not output comprehensive progress report
135
136
137       -r,  --repo=""       repository  to backup to or restore from (default:
138       $RESTIC_REPOSITORY)
139
140
141       --repository-file=""      file to read  the  repository  location  from
142       (default: $RESTIC_REPOSITORY_FILE)
143
144
145       --retry-lock=0s       retry  to  lock  the  repository if it is already
146       locked, takes a value like 5m or 2h (default: no retries)
147
148
149       --tls-client-cert=""      path to a file  containing  PEM  encoded  TLS
150       client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)
151
152
153       -v,  --verbose[=0]       be  verbose (specify multiple times or a level
154       using --verbose=n``, max level/times is 2)
155
156
157

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO