BORG-REPO-SPACE(1) | borg backup tool | BORG-REPO-SPACE(1) |
NAME¶
borg-repo-space - Manage reserved space in repository
SYNOPSIS¶
borg [common options] repo-space [options]
DESCRIPTION¶
This command manages reserved space in a repository.
Borg can not work in disk-full conditions (can not lock a repo and thus can not run prune/delete or compact operations to free disk space).
To avoid running into dead-end situations like that, you can put some objects into a repository that take up some disk space. If you ever run into a disk-full situation, you can free that space and then borg will be able to run normally, so you can free more disk space by using prune/delete/compact. After that, don't forget to reserve space again, in case you run into that situation again at a later time.
Examples:
# Create a new repository: $ borg repo-create ... # Reserve approx. 1GB of space for emergencies: $ borg repo-space --reserve 1G # Check amount of reserved space in the repository: $ borg repo-space # EMERGENCY! Free all reserved space to get things back to normal: $ borg repo-space --free $ borg prune ... $ borg delete ... $ borg compact -v # only this actually frees space of deleted archives $ borg repo-space --reserve 1G # reserve space again for next time
Reserved space is always rounded up to use full reservation blocks of 64MiB.
OPTIONS¶
See borg-common(1) for common options of Borg commands.
options¶
- --reserve SPACE
- Amount of space to reserve (e.g. 100M, 1G). Default: 0.
- --free
- Free all reserved space. Don't forget to reserve space later again.
SEE ALSO¶
AUTHOR¶
The Borg Collective
2024-10-12 |