NAME

       borg-repo-compress - Repository (re-)compression

SYNOPSIS

       borg [common options] repo-compress [options]

DESCRIPTION

       Repository (re-)compression (and/or re-obfuscation).

       Reads all chunks in the repository and recompresses them if they are not already using the
       compression type/level and obfuscation level given via --compression.

       If the outcome of the chunk processing indicates a change  in  compression  type/level  or
       obfuscation level, the processed chunk is written to the repository.  Please note that the
       outcome might not always be the desired compression type/level - if no compression gives a
       shorter output, that might be chosen.

       Please note that this command can not work in low (or zero) free disk space conditions.

       If  the  borg  repo-compress  process  receives a SIGINT signal (Ctrl-C), the repo will be
       committed and compacted and borg will terminate cleanly afterwards.

       Both --progress and --stats are recommended when borg repo-compress is used interactively.

       You do not need to run borg compact after borg repo-compress.

OPTIONS

       See borg-common(1) for common options of Borg commands.

   options
       -C COMPRESSION, --compression COMPRESSION
              select compression algorithm, see the output of the "borg help compression" command
              for details.

       -s, --stats
              print statistics

EXAMPLES

          # recompress repo contents
          $ borg repo-compress --progress --compression=zstd,3

          # recompress and obfuscate repo contents
          $ borg repo-compress --progress --compression=obfuscate,1,zstd,3

SEE ALSO

       borg-common(1)

AUTHOR

       The Borg Collective

                                            2024-11-26                      BORG-REPO-COMPRESS(1)