restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-forget - Remove snapshots from the repository



SSYYNNOOPPSSIISS
       rreessttiicc ffoorrggeett [[ffllaaggss]] [[ssnnaappsshhoott IIDD]] [[......]]



DDEESSCCRRIIPPTTIIOONN
       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.



EEXXIITT SSTTAATTUUSS
       Exit status is 0 if the command was successful, and non-zero  if  there
       was any error.



OOPPTTIIOONNSS
       --ll, ----kkeeeepp--llaasstt=0      keep the last nn snapshots


       --HH, ----kkeeeepp--hhoouurrllyy=0      keep the last nn hourly snapshots


       --dd, ----kkeeeepp--ddaaiillyy=0      keep the last nn daily snapshots


       --ww, ----kkeeeepp--wweeeekkllyy=0      keep the last nn weekly snapshots


       --mm, ----kkeeeepp--mmoonntthhllyy=0      keep the last nn monthly snapshots


       --yy, ----kkeeeepp--yyeeaarrllyy=0      keep the last nn yearly snapshots


       ----kkeeeepp--wwiitthhiinn=       keep  snapshots  that are newer than dduurraattiioonn (eg.
       1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--hhoouurrllyy=      keep hourly snapshots that  are  newer  than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--ddaaiillyy=       keep  daily  snapshots  that  are newer than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--wweeeekkllyy=      keep weekly snapshots that  are  newer  than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--mmoonntthhllyy=       keep monthly snapshots that are newer than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--wwiitthhiinn--yyeeaarrllyy=      keep yearly snapshots that  are  newer  than
       dduurraattiioonn (eg. 1y5m7d2h) relative to the latest snapshot


       ----kkeeeepp--ttaagg=[]       keep  snapshots with this ttaagglliisstt (can be specified
       multiple times)


       ----hhoosstt=[]      only consider snapshots with  the  given  hhoosstt  (can  be
       specified multiple times)


       ----ttaagg=[]      only consider snapshots which include this ttaagglliisstt in the
       format ttaagg[[,,ttaagg,,......]] (can be specified multiple times)


       ----ppaatthh=[]      only consider snapshots which  include  this  (absolute)
       ppaatthh (can be specified multiple times)


       --cc, ----ccoommppaacctt[=false]      use compact output format


       --gg,  ----ggrroouupp--bbyy="host,paths"       string  for  grouping  snapshots  by
       host,paths,tags


       --nn, ----ddrryy--rruunn[=false]      do not  delete  anything,  just  print  what
       would be done


       ----pprruunnee[=false]      automatically run the 'prune' command if snapshots
       have been removed


       ----mmaaxx--uunnuusseedd="5%"      tolerate given lliimmiitt of  unused  data  (absolute
       value  in  bytes  with suffixes k/K, m/M, g/G, t/T, a value in % or the
       word 'unlimited')


       ----mmaaxx--rreeppaacckk--ssiizzee=""      maximum ssiizzee  to  repack  (allowed  suffixes:
       k/K, m/M, g/G, t/T)


       ----rreeppaacckk--ccaacchheeaabbllee--oonnllyy[=false]        only   repack  packs  which  are
       cacheable


       --hh, ----hheellpp[=false]      help for forget



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)
