restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-rewrite - Rewrite snapshots to exclude unwanted files



SSYYNNOOPPSSIISS
       rreessttiicc rreewwrriittee [[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  "rewrite"  command excludes files from existing snapshots. It cre‐
       ates new snapshots containing the same data as the original  ones,  but
       without  the  files  you  specify to exclude. All metadata (time, host,
       tags) will be preserved.


       The snapshots to rewrite are specified  using  the  --host,  --tag  and
       --path  options,  or  by  providing a list of snapshot IDs. Please note
       that specifying neither any of these options nor  a  snapshot  ID  will
       cause the command to rewrite all snapshots.


       The special tag 'rewrite' will be added to the new snapshots to distin‐
       guish them from the original ones, unless  --forget  is  used.  If  the
       --forget  option  is  used,  the  original  snapshots  will  instead be
       directly removed from the repository.


       Please note that the --forget option only removes the snapshots and not
       the  actual  data  stored  in the repository. In order to delete the no
       longer referenced data, use the "prune" command.



EEXXIITT SSTTAATTUUSS
       Exit status is 0 if the command was successful, and non-zero  if  there
       was any error.



OOPPTTIIOONNSS
       --nn, ----ddrryy--rruunn[=false]      do not do anything, just print what would be
       done


       --ee, ----eexxcclluuddee=[]      exclude a  ppaatttteerrnn  (can  be  specified  multiple
       times)


       ----eexxcclluuddee--ffiillee=[]      read exclude patterns from a ffiillee (can be speci‐
       fied multiple times)


       ----ffoorrggeett[=false]      remove original snapshots after creating new ones


       --hh, ----hheellpp[=false]      help for rewrite


       --HH, ----hhoosstt=[]      only consider snapshots for this hhoosstt (can be speci‐
       fied multiple times)


       ----iieexxcclluuddee=[]       same as --exclude ppaatttteerrnn but ignores the casing of
       filenames


       ----iieexxcclluuddee--ffiillee=[]      same as --exclude-file but  ignores  casing  of
       ffiilleenames in patterns


       ----ppaatthh=[]       only  consider snapshots including this (absolute) ppaatthh
       (can be specified multiple times)


       ----ttaagg=[]      only consider snapshots including ttaagg[[,,ttaagg,,......]]  (can  be
       specified multiple times)



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


       ----ccoommpprreessssiioonn=auto      compression mode (only available for repository
       format version 2), one of (auto|off|max)


       ----iinnsseeccuurree--ttllss[=false]      skip TLS certificate verification when con‐
       necting to the repository (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 rraattee in KiB/s.
       (default: unlimited)


       ----lliimmiitt--uuppllooaadd=0      limits  uploads  to  a  maximum  rraattee  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acckk--ssiizzee=0       set target pack ssiizzee in MiB, created pack files may
       be larger (default: $RESTIC_PACK_SIZE)


       ----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 2)



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)
