Scroll to navigation

git-annex-upgrade(1) General Commands Manual git-annex-upgrade(1)


git-annex-upgrade - upgrade repository


git annex upgrade


Upgrades the repository to the latest version.

Each git-annex repository has an annex.version in its git configuration, that indicates the repository version. When an old repository version becomes deprecated, git-annex will automatically upgrade it (unless annex.autoupgraderepository is set to false). To manually upgrade, you can use this command.

Sometimes there's a newer repository version that is not the default yet, and then you can use this command to upgrade to it.

Currently, git-annex supports upgrades all the way back to version 0, which was only used by its author. It's expected that git-annex will always support upgrading from all past repository versions -- this is necessary to allow archives to be taken offline for years and later used.


Only do whatever automatic upgrade can be done, don't necessarily upgrade to the latest version. This is used internally by git-annex.
Enable JSON output. This is intended to be parsed by programs that use git-annex.
Messages that would normally be output to standard error are included in the JSON instead.
git-annex-common-options(1) can be used.




Upgrades procedures and history: <>

News and release notes: <>


Joey Hess <>