restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-forget - Remove snapshots from the repository



SSYYNNOOPPSSIISS
       rreessttiicc ffoorrggeett [[ffllaaggss]] [[ssnnaappsshhoott IIDD]] [[......]]



DDEESSCCRRIIPPTTIIOONN
       The  "forget"  command  removes snapshots according to a policy. Please
       note that this command really only deletes the snapshot object  in  the
       repository,  which  is  a  reference  to data stored there. In order to
       remove the unreferenced data after "forget" was run  successfully,  see
       the "prune" command. Please also read the documentation for "forget" to
       learn about important security considerations.



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
       --ll, ----kkeeeepp--llaasstt=0      keep the last nn snapshots


       --HH, ----kkeeeepp--hhoouurrllyy=0      keep the last nn hourly snapshots


       --dd, ----kkeeeepp--ddaaiillyy=0      keep the last nn daily snapshots


       --ww, ----kkeeeepp--wweeeekkllyy=0      keep the last nn weekly snapshots


       --mm, ----kkeeeepp--mmoonntthhllyy=0      keep the last nn monthly snapshots


       --yy, ----kkeeeepp--yyeeaarrllyy=0      keep the last nn yearly snapshots


       ----kkeeeepp--wwiitthhiinn=       keep  snapshots  that are newer than dduurraattiioonn (eg.
       1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--hhoouurrllyy=      keep hourly snapshots that  are  newer  than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--ddaaiillyy=       keep  daily  snapshots  that  are newer than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--wweeeekkllyy=      keep weekly snapshots that  are  newer  than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--mmoonntthhllyy=       keep monthly snapshots that are newer than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--yyeeaarrllyy=      keep yearly snapshots that  are  newer  than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--ttaagg=[]       keep  snapshots with this ttaagglliisstt (can be specified
       multiple times)


       ----hhoosstt=[]      only consider snapshots with  the  given  hhoosstt  (can  be
       specified multiple times)


       ----ttaagg=[]      only consider snapshots which include this ttaagglliisstt in the
       format ttaagg[[,,ttaagg,,......]] (can be specified multiple times)


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


       --cc, ----ccoommppaacctt[=false]      use compact output format


       --gg,  ----ggrroouupp--bbyy="host,paths"       string  for  grouping  snapshots  by
       host,paths,tags


       --nn, ----ddrryy--rruunn[=false]      do not  delete  anything,  just  print  what
       would be done


       ----pprruunnee[=false]      automatically run the 'prune' command if snapshots
       have been removed


       ----mmaaxx--uunnuusseedd="5%"      tolerate given lliimmiitt of  unused  data  (absolute
       value  in  bytes  with suffixes k/K, m/M, g/G, t/T, a value in % or the
       word 'unlimited')


       ----mmaaxx--rreeppaacckk--ssiizzee=""      maximum ssiizzee  to  repack  (allowed  suffixes:
       k/K, m/M, g/G, t/T)


       ----rreeppaacckk--ccaacchheeaabbllee--oonnllyy[=false]        only   repack  packs  which  are
       cacheable


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



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)
