restic backup(1)                                              restic backup(1)



NNAAMMEE
       restic-backup - Create a new backup of files and/or directories



SSYYNNOOPPSSIISS
       rreessttiicc bbaacckkuupp [[ffllaaggss]] FFIILLEE//DDIIRR [[FFIILLEE//DDIIRR]] ......



DDEESSCCRRIIPPTTIIOONN
       The  "backup"  command  creates  a new snapshot and saves the files and
       directories given as the arguments.



EEXXIITT SSTTAATTUUSS
       Exit status is 0 if the command was successful.  Exit status  is  1  if
       there  was  a  fatal  error (no snapshot created).  Exit status is 3 if
       some source data could not be read (incomplete snapshot created).



OOPPTTIIOONNSS
       --nn, ----ddrryy--rruunn[=false]      do not upload or write any data,  just  show
       what would be done


       --ee,  ----eexxcclluuddee=[]       exclude  a  ppaatttteerrnn  (can be specified multiple
       times)


       ----eexxcclluuddee--ccaacchheess[=false]       excludes  cache  directories  that   are
       marked  with  a CACHEDIR.TAG file. See https://bford.info/cachedir/ for
       the Cache Directory Tagging Standard


       ----eexxcclluuddee--ffiillee=[]      read exclude patterns from a ffiillee (can be speci‐
       fied multiple times)


       ----eexxcclluuddee--iiff--pprreesseenntt=[]       takes ffiilleennaammee[[::hheeaaddeerr]], exclude contents
       of directories containing filename (except filename itself)  if  header
       of that file is as provided (can be specified multiple times)


       ----eexxcclluuddee--llaarrggeerr--tthhaann=""       max  ssiizzee  of  the files to be backed up
       (allowed suffixes: k/K, m/M, g/G, t/T)


       ----ffiilleess--ffrroomm=[]      read the files to backup from ffiillee  (can  be  com‐
       bined with file args; can be specified multiple times)


       ----ffiilleess--ffrroomm--rraaww=[]       read  the  files  to backup from ffiillee (can be
       combined with file args; can be specified multiple times)


       ----ffiilleess--ffrroomm--vveerrbbaattiimm=[]      read the files to backup from  ffiillee  (can
       be combined with file args; can be specified multiple times)


       --ff,  ----ffoorrccee[=false]      force re-reading the target files/directories
       (overrides the "parent" flag)


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


       --HH, ----hhoosstt=""      set the hhoossttnnaammee for the snapshot manually. To  pre‐
       vent an expensive rescan use the "parent" flag


       ----iieexxcclluuddee=[]       same as --exclude ppaatttteerrnn but ignores the casing of
       filenames


       ----iieexxcclluuddee--ffiillee=[]      same as --exclude-file but  ignores  casing  of
       ffiilleenames in patterns


       ----iiggnnoorree--ccttiimmee[=false]      ignore ctime changes when checking for mod‐
       ified files


       ----iiggnnoorree--iinnooddee[=false]      ignore inode number changes  when  checking
       for modified files


       --xx,  ----oonnee--ffiillee--ssyysstteemm[=false]       exclude  other file systems, don't
       cross filesystem boundaries and subvolumes


       ----ppaarreenntt=""      use this parent ssnnaappsshhoott (default:  last  snapshot  in
       the  repo  that has the same target files/directories, and is not newer
       than the snapshot time)


       ----ssttddiinn[=false]      read backup from stdin


       ----ssttddiinn--ffiilleennaammee="stdin"      ffiilleennaammee to use when reading from stdin


       ----ttaagg=[]      add ttaaggss for the new snapshot in the format ttaagg[[,,ttaagg,,......]]
       (can be specified multiple times)


       ----ttiimmee=""      ttiimmee of the backup (ex. '2012-11-01 22:08:41') (default:
       now)


       ----wwiitthh--aattiimmee[=false]      store the atime for all files and directories



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)
