Man page - borg2-delete(1)
Packages contas this manual
- borg2-prune(1)
- borg2-with-lock(1)
- borg2-delete(1)
- borg2-key(1)
- borg2-repo-space(1)
- borg2-mount(1)
- borg2-list(1)
- borg2-info(1)
- borg2-common(1)
- borg2-recreate(1)
- borg2-key-import(1)
- borg2-benchmark-crud(1)
- borg2-match-archives(1)
- borg2-repo-info(1)
- borg2-key-change-location(1)
- borg2-repo-delete(1)
- borg2-compression(1)
- borg2-compact(1)
- borg2-repo-create(1)
- borg2-version(1)
- borg2-key-export(1)
- borg2-break-lock(1)
- borg2-benchmark-cpu(1)
- borgfs2(1)
- borg2-tag(1)
- borgbackup2(1)
- borg2-benchmark(1)
- borg2-rename(1)
- borg2-umount(1)
- borg2-import-tar(1)
- borg2-repo-compress(1)
- borg2-serve(1)
- borg2-undelete(1)
- borg2-placeholders(1)
- borg2-transfer(1)
- borg2(1)
- borg2-analyze(1)
- borg2-export-tar(1)
- borg2-key-change-passphrase(1)
- borg2-extract(1)
- borg2-patterns(1)
- borg2-diff(1)
- borg2-repo-list(1)
- borg2-create(1)
- borg2-check(1)
Package: borgbackup2
apt-get install borgbackup2
apt-get install borgbackup2
Manuals in package:
Documentations in package:
Manual
| BORG-DELETE(1) | borg backup tool | BORG-DELETE(1) |
NAME
borg-delete - Delete archives
SYNOPSIS
borg [common options] delete [options] [NAME]
DESCRIPTION
This command soft-deletes archives from the repository.
Important:
- The delete command will only mark archives for deletion ("soft-deletion"), repository disk space is not freed until you run borg compact.
- You can use borg undelete to undelete archives, but only until you run borg compact.
When in doubt, use --dry-run --list to see what would be deleted.
You can delete multiple archives by specifying a matching pattern, using the --match-archives PATTERN option (for more info on these patterns, see borg_patterns).
OPTIONS
See borg-common(1) for common options of Borg commands.
arguments
- NAME
- specify the archive name
options
- -n, --dry-run
- do not change repository
- --list
- output verbose list of archives
Archive filters
- -a PATTERN, --match-archives PATTERN
- only consider archives matching all patterns. see "borg help match-archives".
- --sort-by KEYS
- Comma-separated list of sorting keys; valid keys are: timestamp, archive, name, id, tags, host, user; default is: timestamp
- --first N
- consider first N archives after other filters were applied
- --last N
- consider last N archives after other filters were applied
- --oldest TIMESPAN
- consider archives between the oldest archive's timestamp and (oldest + TIMESPAN), e.g. 7d or 12m.
- --newest TIMESPAN
- consider archives between the newest archive's timestamp and (newest - TIMESPAN), e.g. 7d or 12m.
- --older TIMESPAN
- consider archives older than (now - TIMESPAN), e.g. 7d or 12m.
- --newer TIMESPAN
- consider archives newer than (now - TIMESPAN), e.g. 7d or 12m.
EXAMPLES
# delete all backup archives named "kenny-files":
$ borg delete -a kenny-files
# actually free disk space:
$ borg compact
# delete a specific backup archive using its unique archive ID prefix
$ borg delete aid:d34db33f
# delete all archives whose names begin with the machine's hostname followed by "-"
$ borg delete -a 'sh:{hostname}-*'
# delete all archives whose names contain "-2012-"
$ borg delete -a 'sh:*-2012-*'
# see what would be deleted if delete was run without --dry-run
$ borg delete --list --dry-run -a 'sh:*-May-*'
SEE ALSO
borg-common(1), borg-compact(1), borg-repo-delete(1)
AUTHOR
The Borg Collective
| 2025-08-04 |