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.



Upgrades procedures and history:

News and release notes:

Joey Hess <>