Scroll to navigation

borg-rename(1) borg backup tool borg-rename(1)

Name

borg-rename - Rename an existing archive.

SYNOPSIS

borg [common options] rename [options] OLDNAME NEWNAME

DESCRIPTION

This command renames an archive in the repository.

This results in a different archive ID.

OPTIONS

See borg-common(1) for common options of Borg commands.

arguments

specify the current archive name
specify the new archive name

EXAMPLES

$ borg create archivename ~
$ borg repo-list
516c2a16  Sat, 2026-08-29 14:39:58 +0200  archivename                  tw          MacBook-Pro
# renaming rewrites the archive metadata, so the archive ID changes:
$ borg rename archivename newname
$ borg repo-list
3aaef11e  Sat, 2026-08-29 14:39:58 +0200  newname                      tw          MacBook-Pro


SEE ALSO

borg-common(1)

Author

The Borg Collective

2026-10-07