restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-copy - Copy snapshots from one repository to another



SSYYNNOOPPSSIISS
       rreessttiicc ccooppyy [[ffllaaggss]] [[ssnnaappsshhoottIIDD ......]]



DDEESSCCRRIIPPTTIIOONN
       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.



OOPPTTIIOONNSS
       --hh, ----hheellpp[=false]      help for copy


       --HH, ----hhoosstt=[]      only consider snapshots for this hhoosstt, when no snap‐
       shot ID is given (can be specified multiple times)


       ----kkeeyy--hhiinntt22=""      key ID of key to  try  decrypting  the  destination
       repository first (default: $RESTIC_KEY_HINT2)


       ----ppaasssswwoorrdd--ccoommmmaanndd22=""       shell  ccoommmmaanndd  to  obtain the destination
       repository password from (default: $RESTIC_PASSWORD_COMMAND2)


       ----ppaasssswwoorrdd--ffiillee22=""      ffiillee to read the destination repository  pass‐
       word from (default: $RESTIC_PASSWORD_FILE2)


       ----ppaatthh=[]       only  consider  snapshots which include this (absolute)
       ppaatthh, when no snapshot ID is given


       ----rreeppoo22=""      destination rreeppoossiittoorryy to copy snapshots  to  (default:
       $RESTIC_REPOSITORY2)


       ----rreeppoossiittoorryy--ffiillee22=""       ffiillee  from  which  to  read the destination
       repository location to  copy  snapshots  to  (default:  $RESTIC_REPOSI‐
       TORY_FILE2)


       ----ttaagg=[]       only consider snapshots which include this ttaagglliisstt, when
       no snapshot ID is given



OOPPTTIIOONNSS IINNHHEERRIITTEEDD FFRROOMM PPAARREENNTT CCOOMMMMAANNDDSS
       ----ccaacceerrtt=[]      ffiillee to load root certificates from (default: use sys‐
       tem certificates)


       ----ccaacchhee--ddiirr=""       set  the  cache  ddiirreeccttoorryy.  (default:  use system
       default cache directory)


       ----cclleeaannuupp--ccaacchhee[=false]      auto remove old cache directories


       ----iinnsseeccuurree--ttllss[=false]      skip TLS certificate verification when con‐
       necting to the repo (insecure)


       ----jjssoonn[=false]       set  output mode to JSON for commands that support
       it


       ----kkeeyy--hhiinntt=""      kkeeyy ID of key  to  try  decrypting  first  (default:
       $RESTIC_KEY_HINT)


       ----lliimmiitt--ddoowwnnllooaadd=0       limits  downloads  to a maximum rate in KiB/s.
       (default: unlimited)


       ----lliimmiitt--uuppllooaadd=0      limits  uploads  to  a  maximum  rate  in  KiB/s.
       (default: unlimited)


       ----nnoo--ccaacchhee[=false]      do not use a local cache


       ----nnoo--lloocckk[=false]       do  not  lock  the repository, this allows some
       operations on read-only repositories


       --oo, ----ooppttiioonn=[]      set extended option (kkeeyy==vvaalluuee, can  be  specified
       multiple times)


       ----ppaasssswwoorrdd--ccoommmmaanndd=""      shell ccoommmmaanndd to obtain the repository pass‐
       word from (default: $RESTIC_PASSWORD_COMMAND)


       --pp, ----ppaasssswwoorrdd--ffiillee=""      ffiillee to read the repository  password  from
       (default: $RESTIC_PASSWORD_FILE)


       --qq, ----qquuiieett[=false]      do not output comprehensive progress report


       --rr,  ----rreeppoo=""       rreeppoossiittoorryy  to backup to or restore from (default:
       $RESTIC_REPOSITORY)


       ----rreeppoossiittoorryy--ffiillee=""      ffiillee to read  the  repository  location  from
       (default: $RESTIC_REPOSITORY_FILE)


       ----ttllss--cclliieenntt--cceerrtt=""       path  to  a  ffiillee containing PEM encoded TLS
       client certificate and private key


       --vv, ----vveerrbboossee[=0]      be verbose (specify multiple times  or  a  level
       using --verbose=nn, max level/times is 3)



SSEEEE AALLSSOO
       rreessttiicc((11))



generated by rreessttiicc ggeenneerraattee       Jan 2017                   restic backup(1)
