borg-rename(1)

💖 NAME 💖

okay so bestie, welcome to borg-rename — that's page 1 of the borg backup tool manual, and it does exactly one (1) thing: it renames an existing archive. that's it. that's the whole job. iconic honestly. 💅

---

✨ SYNOPSIS ✨

borg [common options] rename [options] OLDNAME NEWNAME

---

🌸 DESCRIPTION 🌸

this command renames an archive in the repository. simple as that, no cap.

but here's the tea you NEED to know: renaming an archive gives you a different archive ID. like, the old ID? gone. a whole new one shows up. so if you were emotionally attached to that ID string, sorry babe 🫶

---

🎀 OPTIONS 🎀

for all the common options that Borg commands share, go read borg-common(1) — that's where the group-chat-wide settings live. this page's got nothing extra for you on that front. 💜

🦋 arguments

• OLDNAME — specify the current archive name. that's the one it has right now, the one you're tryna change. ✨
• NEWNAME — specify the new archive name. that's what you want it to be called instead. 🎀

---

🔥 EXAMPLES 🔥

okay watch this, it's gonna eat:

     $ 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 how the ID went from 516c2a16 to 3aaef11e? 👀 that's the whole point — renaming rewrites the archive metadata, so the archive ID changes. the name changed, the ID changed, everything else stayed put. periodt. 💅

---

💫 SEE ALSO 💫

• borg-common(1)

---

👑 Author 👑

The Borg Collective

---

mwah, that's the whole page bestie ✨ this was borg-rename(1), dated 2026-10-07, born from the borg backup tool manual. go rename something, you got this 💖🦋🌸