Man page - borg-repo-space(1)
Packages contas this manual
- borg-tag(1)
- borg-repo-delete(1)
- borg-create(1)
- borg(1)
- borg-mount(1)
- borg-info(1)
- borg-list(1)
- borg-placeholders(1)
- borg-benchmark(1)
- borg-diff(1)
- borg-key-change-passphrase(1)
- borg-repo-compress(1)
- borg-import-tar(1)
- borg-benchmark-crud(1)
- borg-repo-create(1)
- borg-repo-list(1)
- borg-compression(1)
- borg-version(1)
- borg-delete(1)
- borg-undelete(1)
- borg-key-change-location(1)
- borg-recreate(1)
- borg-check(1)
- borg-repo-space(1)
- borg-key(1)
- borg-compact(1)
- borg-umount(1)
- borg-serve(1)
- borg-transfer(1)
- borg-prune(1)
- borg-with-lock(1)
- borg-common(1)
- borg-patterns(1)
- borg-match-archives(1)
- borg-break-lock(1)
- borg-repo-info(1)
- borg-rename(1)
- borg-analyze(1)
- borg-export-tar(1)
- borg-key-export(1)
- borg-extract(1)
- borg-benchmark-cpu(1)
- borgfs(1)
- borg-key-import(1)
apt-get install borgbackup-is-borgbackup2
Manual
| 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
borg-common(1)
AUTHOR
The Borg Collective
| 2025-08-04 |