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.

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