mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-28 02:38:43 +00:00
1bc5902718
in borg 1.x, we used to put a timestamp into the archive name to make it unique, because borg1 required that. borg2 does not require unique archive names, but it encourages you to even use an identical archive name within the same SERIES of archives. that makes matching (e.g. for prune, but also at other places) much simpler and borg KNOWS which archives belong to the same series.
51 lines
2 KiB
ReStructuredText
51 lines
2 KiB
ReStructuredText
.. include:: prune.rst.inc
|
|
|
|
Examples
|
|
~~~~~~~~
|
|
|
|
Be careful, prune is a potentially dangerous command, it will remove backup
|
|
archives.
|
|
|
|
The default of prune is to apply to **all archives in the repository** unless
|
|
you restrict its operation to a subset of the archives.
|
|
|
|
The recommended way to name archives (with ``borg create``) is to use the
|
|
identical archive name within a series of archives. Then you can simply give
|
|
that name to prune also, so it operates just on that series of archives.
|
|
|
|
Alternatively, you can use ``-a`` / ``--match-archives`` to do a match on the
|
|
archive names to select some of them.
|
|
When using ``-a``, be careful to choose a good pattern - e.g. do not use a
|
|
prefix "foo" if you do not also want to match "foobar".
|
|
|
|
It is strongly recommended to always run ``prune -v --list --dry-run ...``
|
|
first so you will see what it would do without it actually doing anything.
|
|
|
|
Don't forget to run ``borg compact -v`` after prune to actually free disk space.
|
|
|
|
::
|
|
|
|
# Keep 7 end of day and 4 additional end of week archives.
|
|
# Do a dry-run without actually deleting anything.
|
|
$ borg prune -v --list --dry-run --keep-daily=7 --keep-weekly=4
|
|
|
|
# Similar as above but only apply to the archive series named '{hostname}':
|
|
$ borg prune -v --list --keep-daily=7 --keep-weekly=4 '{hostname}'
|
|
|
|
# Similar as above but apply to archive names starting with the hostname
|
|
# of the machine followed by a "-" character:
|
|
$ borg prune -v --list --keep-daily=7 --keep-weekly=4 -a 'sh:{hostname}-*'
|
|
|
|
# Keep 7 end of day, 4 additional end of week archives,
|
|
# and an end of month archive for every month:
|
|
$ borg prune -v --list --keep-daily=7 --keep-weekly=4 --keep-monthly=-1
|
|
|
|
# Keep all backups in the last 10 days, 4 additional end of week archives,
|
|
# and an end of month archive for every month:
|
|
$ borg prune -v --list --keep-within=10d --keep-weekly=4 --keep-monthly=-1
|
|
|
|
There is also a visualized prune example in ``docs/misc/prune-example.txt``:
|
|
|
|
.. highlight:: none
|
|
.. include:: ../misc/prune-example.txt
|
|
:literal:
|