borg2-undelete(1)

Usage

borg [common options] undelete [options] [NAME]

Overview

This command undeletes archives in the repository.

Important: Undeleting archives is only possible before compacting. Once borg compact has run, all disk space occupied only by the soft-deleted archives will be freed and undelete is not possible anymore.

When in doubt, use --dry-run --list to see what would be undeleted.

You can undelete 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.