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

OPTIONS INHERITED FROM PARENT COMMANDS

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

SEE ALSO

142       restic(1)
143
144
145
146generated by restic generate       Jan 2017                   restic backup(1)
Impressum