restic-copy(1)

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       --from-key-hint=""       key  ID  of  key  to try decrypting the source
38       repository first (default: $RESTIC_FROM_KEY_HINT)
39
40
41       --from-password-command=""      shell  command  to  obtain  the  source
42       repository password from (default: $RESTIC_FROM_PASSWORD_COMMAND)
43
44
45       --from-password-file=""       file  to read the source repository pass‐
46       word from (default: $RESTIC_FROM_PASSWORD_FILE)
47
48
49       --from-repo=""      source repository to copy snapshots from  (default:
50       $RESTIC_FROM_REPOSITORY)
51
52
53       --from-repository-file=""       file  from  which  to  read  the source
54       repository    location    to    copy    snapshots    from     (default:
55       $RESTIC_FROM_REPOSITORY_FILE)
56
57
58       -h, --help[=false]      help for copy
59
60
61       -H, --host=[]      only consider snapshots for this host (can be speci‐
62       fied multiple times)
63
64
65       --path=[]      only consider snapshots including this  (absolute)  path
66       (can be specified multiple times)
67
68
69       --tag=[]       only  consider snapshots including tag[,tag,...] (can be
70       specified multiple times)
71
72
73

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO