restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-copy - Copy snapshots from one repository to another



SSYYNNOOPPSSIISS
       rreessttiicc ccooppyy [[ffllaaggss]] [[ssnnaappsshhoottIIDD ......]]



DDEESSCCRRIIPPTTIIOONN
       The  "copy" command copies one or more snapshots from one repository to
       another.


       NOTE: This process will have to both download (read) and upload (write)
       the entire snapshot(s) due to the different encryption keys used in the
       source and destination repositories. This /may incur  higher  bandwidth
       usage and costs/ than expected during normal backup runs.


       NOTE:  The  copying  process  does  not re-chunk files, which may break
       deduplication between the files copied and files already stored in  the
       destination repository.  This means that copied files, which existed in
       both the source and destination repository, /may  occupy  up  to  twice
       their  space/  in the destination repository.  This can be mitigated by
       the "--copy-chunker-params" option when initializing a new  destination
       repository using the "init" command.



OOPPTTIIOONNSS
       --hh, ----hheellpp[=false]      help for copy


       --HH, ----hhoosstt=[]      only consider snapshots for this hhoosstt, when no snap‐
       shot ID is given (can be specified multiple times)


       ----kkeeyy--hhiinntt22=""      key ID of key to  try  decrypting  the  destination
       repository first (default: $RESTIC_KEY_HINT2)


       ----ppaasssswwoorrdd--ccoommmmaanndd22=""       shell  ccoommmmaanndd  to  obtain the destination
       repository password from (default: $RESTIC_PASSWORD_COMMAND2)


       ----ppaasssswwoorrdd--ffiillee22=""      ffiillee to read the destination repository  pass‐
       word from (default: $RESTIC_PASSWORD_FILE2)


       ----ppaatthh=[]       only  consider  snapshots which include this (absolute)
       ppaatthh, when no snapshot ID is given


       ----rreeppoo22=""      destination rreeppoossiittoorryy to copy snapshots  to  (default:
       $RESTIC_REPOSITORY2)


       ----rreeppoossiittoorryy--ffiillee22=""       ffiillee  from  which  to  read the destination
       repository location to  copy  snapshots  to  (default:  $RESTIC_REPOSI‐
       TORY_FILE2)


       ----ttaagg=[]       only consider snapshots which include this ttaagglliisstt, when
       no snapshot ID is given



OOPPTTIIOONNSS IINNHHEERRIITTEEDD FFRROOMM PPAARREENNTT CCOOMMMMAANNDDSS
       ----ccaacceerrtt=[]      ffiillee to load root certificates from (default: use sys‐
       tem certificates)


       ----ccaacchhee--ddiirr=""       set  the  cache  ddiirreeccttoorryy.  (default:  use system
       default cache directory)


       ----cclleeaannuupp--ccaacchhee[=false]      auto remove old cache directories


       ----iinnsseeccuurree--ttllss[=false]      skip TLS certificate verification when con‐
       necting to the repo (insecure)


       ----jjssoonn[=false]       set  output mode to JSON for commands that support
       it


       ----kkeeyy--hhiinntt=""      kkeeyy ID of key  to  try  decrypting  first  (default:
       $RESTIC_KEY_HINT)


       ----lliimmiitt--ddoowwnnllooaadd=0       limits  downloads  to a maximum rate in KiB/s.
       (default: unlimited)


       ----lliimmiitt--uuppllooaadd=0      limits  uploads  to  a  maximum  rate  in  KiB/s.
       (default: unlimited)


       ----nnoo--ccaacchhee[=false]      do not use a local cache


       ----nnoo--lloocckk[=false]       do  not  lock  the repository, this allows some
       operations on read-only repositories


       --oo, ----ooppttiioonn=[]      set extended option (kkeeyy==vvaalluuee, can  be  specified
       multiple times)


       ----ppaasssswwoorrdd--ccoommmmaanndd=""      shell ccoommmmaanndd to obtain the repository pass‐
       word from (default: $RESTIC_PASSWORD_COMMAND)


       --pp, ----ppaasssswwoorrdd--ffiillee=""      ffiillee to read the repository  password  from
       (default: $RESTIC_PASSWORD_FILE)


       --qq, ----qquuiieett[=false]      do not output comprehensive progress report


       --rr,  ----rreeppoo=""       rreeppoossiittoorryy  to backup to or restore from (default:
       $RESTIC_REPOSITORY)


       ----rreeppoossiittoorryy--ffiillee=""      ffiillee to read  the  repository  location  from
       (default: $RESTIC_REPOSITORY_FILE)


       ----ttllss--cclliieenntt--cceerrtt=""       path  to  a  ffiillee containing PEM encoded TLS
       client certificate and private key


       --vv, ----vveerrbboossee[=0]      be verbose (specify multiple times  or  a  level
       using --verbose=nn, max level/times is 3)



SSEEEE AALLSSOO
       rreessttiicc((11))



generated by rreessttiicc ggeenneerraattee       Jan 2017                   restic backup(1)
