Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

git-annex

git-annex.branchable.com

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • Web
  • Android
  • API
  • Self-hosted

What git-annex is

git-annex manages large files alongside Git while keeping their contents outside Git itself. Git tracks filenames and metadata; git-annex stores the file contents in a distributed store across repository clones. The tool can synchronize, back up and archive data online or offline, and resume interrupted transfers. Its assistant can create a synchronized folder across computers, Android devices, removable drives, NAS appliances and cloud services. Built-in special remotes include S3, Glacier, rclone, rsync, web, WebDAV and Android adb. Encrypted special remotes can encrypt file contents and use HMAC hashing for filenames, but the project says encryption is mostly not used by default. The project describes git-annex as intended for Git users who like working at the command line. Installation instructions cover Linux distributions, macOS, Android and Windows. The project says file size is limited by the filesystem; repositories with hundreds of thousands of files are supported, while larger repositories may slow down because of Git limitations. It also states that git-annex is not a backup system, though it can be part of an archival setup or deliver files to another backup system.

Who it suits

git-annex suits Git users comfortable with the command line who need to manage large files across repositories and storage locations. It may also fit archival workflows, but the project says it is not itself a backup system.

Good to know, and what to watch

  • Keeps large file contents outside Git
  • Can sync and archive data online or offline
  • Resumes interrupted transfers
  • Includes many built-in special remotes
  • Install instructions cover four platform groups
  • Designed for Git users who like the command line
  • Encryption is mostly not used by default
  • Not a backup system
  • Large repositories may slow down due to Git limitations

git-annex

Free

Open source

The verdict

git-annex provides a Git-based way to manage file contents across clones and connected storage, with transfer-resume and remote options. Treat it as part of a storage or archival workflow rather than as a standalone backup system.

What the maker publishes

Assistant
The git-annex assistant creates a synchronized folder across computers, Android devices, removable drives, NAS appliances, and cloud services. source
Assistant
The bundled assistant synchronizes folders across macOS and Linux computers, Android devices, removable drives, NAS appliances and cloud services. source
Audience
The project describes git-annex as designed for git users who love the command line. source
Checksums
Files can use cryptographic checksum keys and git-annex fsck can verify stored content. source
Company status
An independent review describes git-annex as maintained by Joey Hess and volunteers rather than a commercial company. source
Current issues
The bug list includes an addurl signal-4 crash, S3/Minio data-loss concern, macOS openrsync sync breakage, slow webapp behavior and memory exhaustion reports. source
Data workflows
It can sync, back up, and archive data both offline and online. source
Documentation
The project provides a wiki, walkthroughs, man pages, design documents, special-remote recipes, a forum, IRC and a mailing list. source
Encryption
Encrypted special remotes can encrypt file contents and use HMAC hashing for filenames; the site says git-annex mostly does not use encryption by default. source
Encryption
Encrypted special remotes support hybrid, shared, public-key and shared-public-key modes, but encryption is generally disabled unless configured. source
Extensibility
Users can write external special remotes, and the project documents external-remote and external-backend protocols. source
Founded
Development began in 2010. source
Funding
A campaign page records 541 sponsors and $20,819 raised against a $15,000 goal for development work. source
Independent user concern
A 2018 survey respondent said the complexity and quirks made recovery from mistakes difficult and requested more troubleshooting guidance. source
Installation
Packages or commands are provided for major Linux distributions, macOS Homebrew, FreeBSD, OpenBSD, Android Termux and Windows through PyPI tooling. source
Install options
Official install instructions list Linux distributions, macOS, Android, and Windows, with package and other install methods. source
Integrations
Documented service recipes cover Amazon S3 and Glacier, Backblaze B2, Dropbox, Google Cloud Storage, Google Drive, Azure, OneDrive, ownCloud and others. source
Licence
The project is AGPL version 3 or later, with portions under GPL, BSD and other free-software licences. source
Limit: Android
An Android report says FAT or sdcardfs environments may lack symlink support, causing duplicate copies and extra storage use, while permissions can also interfere. source
Limit: assistant workflow
The hands-on report said automatic assistant commits made the Git log messy, leading the author to disable the assistant and commit manually. source
Limitations
The project says git-annex is not a backup system, though it may be part of an archival system or deliver files to a backup system. source
Limit: backup expectations
The project’s own explanatory page says git-annex is not itself a backup system, Dropbox replacement, filesystem mirror or distributed filesystem. source
Limit: large repositories
A Washington State University guide reports slow Git and git-annex performance with many files and says building from Haskell source is difficult. source
Limit: learning curve
A hands-on user found the software substantially more complex than typical tools and said its documentation is difficult to digest. source

Checked against the maker's pages on 15 Oct 2026.