restic backup(1)                                              restic backup(1)



NAME
       restic-prune - Remove unneeded data from the repository



SYNOPSIS
       restic prune [flags]



DESCRIPTION
       The "prune" command checks the repository and removes data that is not
       referenced and therefore not needed any more.



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



OPTIONS
       -n, --dry-run[=false]    do not modify the repository, just print what
       would be done


       -h, --help[=false]  help for prune


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


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


       --repack-cacheable-only[=false]    only repack packs which are
       cacheable


       --repack-small[=false]   repack pack files below 80% of target pack
       size


       --repack-uncompressed[=false]      repack all uncompressed data


       --unsafe-recover-no-free-space=""  UNSAFE, READ THE DOCUMENTATION
       BEFORE USING! Try to recover a repository stuck with no free space. Do
       not use without trying out 'prune --max-repack-size 0' first.



OPTIONS INHERITED FROM PARENT COMMANDS
       --cacert=[]    file to load root certificates from (default: use system
       certificates or $RESTIC_CACERT)


       --cache-dir=""      set the cache directory. (default: use system
       default cache directory)


       --cleanup-cache[=false]  auto remove old cache directories


       --compression=auto  compression mode (only available for repository
       format version 2), one of (auto|off|max) (default: $RESTIC_COMPRESSION)


       --insecure-tls[=false]   skip TLS certificate verification when
       connecting to the repository (insecure)


       --json[=false]      set output mode to JSON for commands that support
       it


       --key-hint=""  key ID of key to try decrypting first (default:
       $RESTIC_KEY_HINT)


       --limit-download=0  limits downloads to a maximum rate in KiB/s.
       (default: unlimited)


       --limit-upload=0    limits uploads to a maximum rate in KiB/s.
       (default: unlimited)


       --no-cache[=false]  do not use a local cache


       --no-extra-verify[=false]     skip additional verification of data
       before upload (see documentation)


       --no-lock[=false]   do not lock the repository, this allows some
       operations on read-only repositories


       -o, --option=[]     set extended option (key=value, can be specified
       multiple times)


       --pack-size=0  set target pack size in MiB, created pack files may be
       larger (default: $RESTIC_PACK_SIZE)


       --password-command=""    shell command to obtain the repository
       password from (default: $RESTIC_PASSWORD_COMMAND)


       -p, --password-file=""   file to read the repository password from
       (default: $RESTIC_PASSWORD_FILE)


       -q, --quiet[=false]      do not output comprehensive progress report


       -r, --repo=""  repository to backup to or restore from (default:
       $RESTIC_REPOSITORY)


       --repository-file=""     file to read the repository location from
       (default: $RESTIC_REPOSITORY_FILE)


       --retry-lock=0s     retry to lock the repository if it is already
       locked, takes a value like 5m or 2h (default: no retries)


       --tls-client-cert=""     path to a file containing PEM encoded TLS
       client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)


       -v, --verbose[=0]   be verbose (specify multiple times or a level using
       --verbose=n``, max level/times is 2)



SEE ALSO
       restic(1)

generated by restic generate       Jan 2017                   restic backup(1)