borg-key-migrate-to-repokey(1)

💖 borg-key-migrate-to-repokey(1) 💖

okay so bestie, welcome to the borg backup tool manual page for borg-key-migrate-to-repokey — the little glow-up ritual that takes your repo from passphrase mode to repokey mode. it's giving character development era tbh ✨

✨ NAME ✨

borg-key-migrate-to-repokey — migrate passphrase -> repokey 🦋

🌸 SYNOPSIS 🌸

borg [common options] key migrate-to-repokey [options] [REPOSITORY]

💅 DESCRIPTION 💅

okay so listen. this command migrates a repository from passphrase mode (which got removed back in Borg 1.0, rip to that era 😭) to repokey mode. no cap, it's a whole makeover.

first thing that happens: you get asked for the repository passphrase, because borg needs to open it in passphrase mode. and yeah — this is the exact same passphrase you used for this repository back before 1.0. the OGs remember 💜

then the different secrets get derived from that passphrase. slay.

after that, you'll be asked for a new passphrase — twice, for safety, because we're careful girlies 🎀 this passphrase is what protects the repokey (which holds these same secrets, just in encrypted form). and here's the tea: you may use the same passphrase you used to use, but you may also use a totally different one. your call, your vibe 👑

once you've migrated to repokey mode, you can change the passphrase at any time. iconic. but please note: the secrets will always stay the same, and they could always be derived from your (old) passphrase-mode passphrase. so like… keep that in mind fr fr 🙈

🔥 OPTIONS 🔥

see borg-common(1) for the common options of Borg commands. they're the shared wardrobe everyone borrows from 💖

arguments

• REPOSITORY — the repo you're doing this glow-up on ✨

👀 SEE ALSO 👀

• borg-common(1)

---

🌈 Author 🌈

The Borg Collective 👑

---

and that's the whole page bestie!! this was borg-key-migrate-to-repokey(1) from the borg backup tool, dated 2026-07-18. go forth and migrate, you absolute main character 🫶💖✨