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

NAME

6       restic-copy - Copy snapshots from one repository to another
7
8
9

SYNOPSIS

11       restic copy [flags] [snapshotID ...]
12
13
14

DESCRIPTION

16       The "copy" command copies one or more snapshots from one repository to
17       another.
18
19
20       NOTE: This process will have to both download (read) and upload (write)
21       the entire snapshot(s) due to the different encryption keys used in the
22       source and destination repositories. This /may incur higher bandwidth
23       usage and costs/ than expected during normal backup runs.
24
25
26       NOTE: The copying process does not re-chunk files, which may break
27       deduplication between the files copied and files already stored in the
28       destination repository.  This means that copied files, which existed in
29       both the source and destination repository, /may occupy up to twice
30       their space/ in the destination repository.  This can be mitigated by
31       the "--copy-chunker-params" option when initializing a new destination
32       repository using the "init" command.
33
34
35

OPTIONS

37       -h, --help[=false]
38           help for copy
39
40
41       -H, --host=[]
42           only consider snapshots for this host, when no snapshot ID is given
43       (can be specified multiple times)
44
45
46       --key-hint2=""
47           key ID of key to try decrypting the destination repository first
48       (default: $RESTIC_KEY_HINT2)
49
50
51       --password-command2=""
52           shell command to obtain the destination repository password from
53       (default: $RESTIC_PASSWORD_COMMAND2)
54
55
56       --password-file2=""
57           file to read the destination repository password from (default:
58       $RESTIC_PASSWORD_FILE2)
59
60
61       --path=[]
62           only consider snapshots which include this (absolute) path, when no
63       snapshot ID is given
64
65
66       --repo2=""
67           destination repository to copy snapshots to (default:
68       $RESTIC_REPOSITORY2)
69
70
71       --tag=[]
72           only consider snapshots which include this taglist, when no
73       snapshot ID is given
74
75
76

OPTIONS INHERITED FROM PARENT COMMANDS

78       --cacert=[]
79           file to load root certificates from (default: use system
80       certificates)
81
82
83       --cache-dir=""
84           set the cache directory. (default: use system default cache
85       directory)
86
87
88       --cleanup-cache[=false]
89           auto remove old cache directories
90
91
92       --json[=false]
93           set output mode to JSON for commands that support it
94
95
96       --key-hint=""
97           key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
98
99
100       --limit-download=0
101           limits downloads to a maximum rate in KiB/s. (default: unlimited)
102
103
104       --limit-upload=0
105           limits uploads to a maximum rate in KiB/s. (default: unlimited)
106
107
108       --no-cache[=false]
109           do not use a local cache
110
111
112       --no-lock[=false]
113           do not lock the repository, this allows some operations on
114       read-only repositories
115
116
117       -o, --option=[]
118           set extended option (key=value, can be specified multiple times)
119
120
121       --password-command=""
122           shell command to obtain the repository password from (default:
123       $RESTIC_PASSWORD_COMMAND)
124
125
126       -p, --password-file=""
127           file to read the repository password from (default:
128       $RESTIC_PASSWORD_FILE)
129
130
131       -q, --quiet[=false]
132           do not output comprehensive progress report
133
134
135       -r, --repo=""
136           repository to backup to or restore from (default:
137       $RESTIC_REPOSITORY)
138
139
140       --repository-file=""
141           file to read the repository location from (default:
142       $RESTIC_REPOSITORY_FILE)
143
144
145       --tls-client-cert=""
146           path to a file containing PEM encoded TLS client certificate and
147       private key
148
149
150       -v, --verbose[=0]
151           be verbose (specify multiple times or a level using --verbose=n,
152       max level/times is 3)
153
154
155

SEE ALSO

157       restic(1)
158
159
160
161generated by `restic generate`     Jan 2017                   restic backup(1)