BORG-CHANGE-PASSPHRASE(1)

πŸ’– BORG-CHANGE-PASSPHRASE(1) πŸ’–

okay bestie, so this is a page from the borg backup tool manual, and it's literally all about changing your repo's passphrase. no cap. let's get into it ✨


🌸 NAME 🌸

borg-change-passphrase β€” change that repository key file passphrase, periodt πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

borg [common options] change-passphrase [options] [REPOSITORY]

like, that's the whole vibe. borg, then your common options, then change-passphrase, then its own options, then maybe a REPOSITORY if you're feeling generous πŸŽ€


✨ DESCRIPTION ✨

so here's the tea 🍡 β€” the key files that handle your repository encryption? they're optionally passphrase protected. "optionally" is doing a lot of work there, iykyk. and this command right here is the one you use to change that passphrase. iconic.

🚨 okay but listen, this part is IMPORTANT and I need you to actually read it, not just scroll past like it's a group chat notification 🚨

this command only changes the passphrase β€” that's it. it does NOT change any secret that's protected by it. we're talking stuff like your encryption/MAC keys, or your chunker seed. those stay exactly the same, bestie.

which means… if your passphrase and your borg key already got compromised? changing the passphrase afterwards does not protect future backups to that same repository. and it doesn't protect past ones either. the way that compromise just… persists 😭. so yeah, that's the vibe check you needed.


πŸ’… OPTIONS πŸ’…

for the common options that every Borg command shares, go peek at borg-common(1). that's where the shared lore lives 🫢

πŸ“ arguments

  • REPOSITORY β€” the repo you're doing this to. you know the one.

🌈 SEE ALSO 🌈


πŸ‘‘ AUTHOR πŸ‘‘

The Borg Collective β€” the whole squad, fr fr πŸ’œ


and that's a wrap, babe! this little page came from the borg backup tool manual, dated 2017-11-25 β€” shoutout to that timestamp for holding it down. now go forth and change those passphrases responsibly βœ¨πŸ¦‹πŸ’–