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
Plans
Every plan and pricegit-annex
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.