git-annex-upgrade(1)

✨ git-annex-upgrade ✨

okay bestie, so this is the git-annex-upgrade manual page, and we're about to make your repo glow up 💅

🌸 NAME 🌸

git-annex-upgrade — upgrade repository

🦋 SYNOPSIS 🦋

git annex upgrade

💖 DESCRIPTION 💖

So like, this command upgrades your repository to the latest version. Periodt.

Every single git-annex repository has an annex.version chillin' in its git configuration, and that's the thing that tells you what version the repo is. When an old repo version gets deprecated (rip bozo), git-annex will automatically upgrade it for you — unless annex.autoupgraderepository is set to false, in which case it minds its own business. But if you wanna do it manually, bestie, this command is right there for you 🫶

Sometimes there's a newer repository version that isn't the default yet, and in that case you can use this command to upgrade to it. slay ✨

Currently, git-annex supports upgrades all the way back to version 0, which was only used by its author (a true icon tbh 👑). And it's expected that git-annex will always support upgrading from all past repository versions — that's necessary so you can take archives offline for years and then come back and use them later. no cap, that's the whole point 🗄️💫

🎀 OPTIONS 🎀

• --autoonly — only do whatever the automatic upgrade can do, and don't necessarily upgrade to the latest version. This one is used internally by git-annex, so it's giving very much backstage pass energy 🙈
• --json — enable JSON output. This is intended to be parsed by programs that use git-annex, so if that's your vibe, here you go 📦✨
• --json-error-messages — messages that would normally be output to standard error get included in the JSON instead. lowkey handy fr fr

Also the git-annex-common-options(1) can be used. don't forget her 💜

🌈 SEE ALSO 🌈

• git-annex(1)
• git-annex-migrate(1)
• Upgrades procedures and history: <http://git-annex.branchable.com/upgrades>
• News and release notes: <http://git-annex.branchable.com/news/>

💜 AUTHOR 💜

Joey Hess <id@joeyh.name> — actual legend, main character energy, we stan 🫶👑

and that's the whole git-annex-upgrade(1) manual page, bestie — same facts, immaculate vibes, no notes 💅✨ bye love u 🎀🦋