---
name: "git-annex-upgrade"
section: "1"
platform: "linux"
package: "git-annex"
version: "10.20261026-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-annex-upgrade"
---

# git-annex-upgrade(1)

upgrade repository

## NAME

git-annex-upgrade - upgrade repository

## SYNOPSIS

git annex upgrade

## DESCRIPTION

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.

## OPTIONS

- \--autoonly

  -

  Only do whatever automatic upgrade can be done, don't necessarily upgrade to the latest version. This is used internally by git-annex.

-

  - **--json**

  Enable JSON output. This is intended to be parsed by programs that use git-annex.

-

  - **--json-error-messages**

  Messages that would normally be output to standard error are included in the JSON instead.

-

  - Also the [git-annex-common-options(1)](/git-annex-common-options/1.md) can be used.

  ## SEE ALSO

[git-annex(1)](/git-annex/1.md)

[git-annex-migrate(1)](/git-annex-migrate/1.md)

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\>