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

OLDNAME
    specify the current archive name

NEWNAME
    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