---
name: "borg2-undelete"
section: "1"
platform: "linux"
package: "borgbackup2"
version: "2.0.0b19-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/borg2-undelete"
---

# borg2-undelete(1)

Undelete archives

## NAME

borg-undelete - Undelete archives

## SYNOPSIS

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

## DESCRIPTION

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)](/borg-common/1.md)* 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.

## SEE ALSO

*[borg-common(1)](/borg-common/1.md)*

## AUTHOR

The Borg Collective