delete

Here's the command-line help for this action in the most recent version of borgmatic. If you're using an older version, some of these flags may not work, and you should instead run the action with --help to see the flags specific to your borgmatic version.

usage: borgmatic delete [--repository REPOSITORY] [--archive ARCHIVE] [--list]
                        [--stats] [--cache-only] [--force]
                        [--keep-security-info] [--save-space]
                        [--checkpoint-interval SECONDS] [-a PATTERN]
                        [--sort-by KEYS] [--first N] [--last N]
                        [--oldest TIMESPAN] [--newest TIMESPAN]
                        [--older TIMESPAN] [--newer TIMESPAN] [-h]

Delete an archive from a repository or delete an entire repository (with Borg
1.2+, you must run compact afterwards to actually free space)

delete arguments:
  --repository REPOSITORY
                        Path of repository to delete or delete archives from,
                        defaults to the configured repository if there is only
                        one, quoted globs supported
  --archive ARCHIVE     Archive name, hash, or series to delete
  --list                Show details for the deleted archives
  --stats               Display statistics for the deleted archives
  --cache-only          Delete only the local cache for the given repository
  --force               Force deletion of corrupted archives, can be given
                        twice if once does not work
  --keep-security-info  Do not delete the local security info when deleting a
                        repository
  --save-space          Work slower, but using less space [Not supported in
                        Borg 2.x+]
  --checkpoint-interval SECONDS
                        Write a checkpoint at the given interval, defaults to
                        1800 seconds (30 minutes)
  -a PATTERN, --match-archives PATTERN, --glob-archives PATTERN
                        Only delete archives with names, hashes, or series
                        matching this pattern
  --sort-by KEYS        Comma-separated list of sorting keys
  --first N             Delete first N archives after other filters are
                        applied
  --last N              Delete last N archives after other filters are applied
  --oldest TIMESPAN     Delete archives within a specified time range starting
                        from the timestamp of the oldest archive (e.g. 7d or
                        12m) [Borg 2.x+ only]
  --newest TIMESPAN     Delete archives within a time range that ends at
                        timestamp of the newest archive and starts a specified
                        time range ago (e.g. 7d or 12m) [Borg 2.x+ only]
  --older TIMESPAN      Delete archives that are older than the specified time
                        range (e.g. 7d or 12m) from the current time [Borg
                        2.x+ only]
  --newer TIMESPAN      Delete archives that are newer than the specified time
                        range (e.g. 7d or 12m) from the current time [Borg
                        2.x+ only]
  -h, --help            Show this help message and exit