Skip to content
SPECIFICTION
Get listed

git-annex

git-annex.branchable.com

Free plan Open source WebWindowsmacOSLinuxAndroidAPI
Visit git-annex.branchable.com
Spec score 8.7 #5 of 36 in Data Version Control Tools

What it is

git-annex manages large files alongside Git while keeping file contents outside Git itself. Git tracks filenames and metadata, while git-annex stores contents in a distributed store across repository clones. It can synchronize, back up, and archive data online or offline, and it can resume interrupted transfers. The assistant can create a synchronized folder spanning 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 remotes can protect file contents and use HMAC hashing for filenames, though the project says encryption is mostly not enabled by default. The project describes git-annex as intended for Git users who like command-line work. File size is limited by the filesystem; repositories with hundreds of thousands of files are supported, while larger repositories may slow down due to Git limitations. It is free software, with installation methods listed for Linux distributions, macOS, Android, and Windows. The project explicitly says it is not a backup system, though it can contribute to archival or backup workflows.

Spec sheet

What it does
git-annex manages large files with Git while keeping their contents outside Git history, and supports synchronization, backup and archiving.Read 15 Oct 2026 · git-annex.branchable.com
Purpose
git-annex manages large files with git while keeping their contents outside git.Read 4 Oct 2026 · git-annex.branchable.com
Audience
The project describes git-annex as designed for git users who love the command line.Read 4 Oct 2026 · git-annex.branchable.com
Integrations
Documented service recipes cover Amazon S3 and Glacier, Backblaze B2, Dropbox, Google Cloud Storage, Google Drive, Azure, OneDrive, ownCloud and others.Read 15 Oct 2026 · git-annex.branchable.com
Support
The official site provides a user forum and a contact page.Read 4 Oct 2026 · git-annex.branchable.com
Founded
Development began in 2010.Read 15 Oct 2026 · en.wikipedia.org
Maker
The contact page identifies Joey Hess as the author, with contributions from others.Read 15 Oct 2026 · git-annex.branchable.com
Assistant
The bundled assistant synchronizes folders across macOS and Linux computers, Android devices, removable drives, NAS appliances and cloud services.Read 15 Oct 2026 · git-annex.branchable.com
Checksums
Files can use cryptographic checksum keys and git-annex fsck can verify stored content.Read 15 Oct 2026 · reddit.com
Company status
An independent review describes git-annex as maintained by Joey Hess and volunteers rather than a commercial company.Read 15 Oct 2026 · gappsy.com
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.Read 15 Oct 2026 · git-annex.branchable.com
Data workflows
It can sync, back up, and archive data both offline and online.Read 4 Oct 2026 · git-annex.branchable.com
Documentation
The project provides a wiki, walkthroughs, man pages, design documents, special-remote recipes, a forum, IRC and a mailing list.Read 15 Oct 2026 · git-annex.branchable.com
Encryption
Encrypted special remotes support hybrid, shared, public-key and shared-public-key modes, but encryption is generally disabled unless configured.Read 15 Oct 2026 · git-annex.branchable.com
Extensibility
Users can write external special remotes, and the project documents external-remote and external-backend protocols.Read 15 Oct 2026 · git-annex.branchable.com
Funding
A campaign page records 541 sponsors and $20,819 raised against a $15,000 goal for development work.Read 15 Oct 2026 · campaign.joeyh.name
Independent user concern
A 2018 survey respondent said the complexity and quirks made recovery from mistakes difficult and requested more troubleshooting guidance.Read 15 Oct 2026 · git-annex-survey.branchable.com
Install options
Official install instructions list Linux distributions, macOS, Android, and Windows, with package and other install methods.Read 4 Oct 2026 · git-annex.branchable.com
Installation
Packages or commands are provided for major Linux distributions, macOS Homebrew, FreeBSD, OpenBSD, Android Termux and Windows through PyPI tooling.Read 15 Oct 2026 · git-annex.branchable.com
Licence
The project is AGPL version 3 or later, with portions under GPL, BSD and other free-software licences.Read 15 Oct 2026 · git-annex.branchable.com
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.Read 15 Oct 2026 · dennissalzner.de
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.Read 15 Oct 2026 · switowski.com
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.Read 15 Oct 2026 · git-annex.branchable.com
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.Read 15 Oct 2026 · swan.physics.wsu.edu
Limit: learning curve
A hands-on user found the software substantially more complex than typical tools and said its documentation is difficult to digest.Read 15 Oct 2026 · switowski.com
Limit: symlink workflow
The same user found annexed images becoming symlinks confusing and said the basic walkthrough did not clearly explain a Google Drive workflow.Read 15 Oct 2026 · switowski.com
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.Read 4 Oct 2026 · git-annex.branchable.com
Praise: flexibility
Independent coverage praises storing content across SSH, rsync, S3, external drives and other repositories without dependence on one central service.Read 15 Oct 2026 · swan.physics.wsu.edu
Praise: reliability
A Reddit user managing about 18 TB described git-annex as very well designed and reliable, praising copy-count enforcement, location tracking and fsck.Read 15 Oct 2026 · reddit.com
Rating on Gappsy
76 out of 100 from an editorial scorecard; the page does not report a user-review count.Read 15 Oct 2026 · gappsy.com
Recent fixes
Version 10.20261005 addressed remote hangs, concurrent identical imports, possible corruption, WebDAV credential hangs and authentication coverage.Read 15 Oct 2026 · git-annex.branchable.com
Recent release
Version 10.20261006 was posted on October 6, 2026.Read 15 Oct 2026 · git-annex.branchable.com
Related tools
The site says DataLad uses git-annex to provide access to scientific data from various sources.Read 4 Oct 2026 · git-annex.branchable.com
Remote integrations
Built-in special remotes include S3, Glacier, rclone, rsync, web, WebDAV, and Android adb.Read 4 Oct 2026 · git-annex.branchable.com
Repository remotes
Most special remotes store file content but not a Git repository clone, so normal push and pull require an exception such as git-remote-annex.Read 15 Oct 2026 · git-annex.branchable.com
Scalability
The project says file size is limited mainly by the filesystem, memory is designed to remain constant, and hundreds of thousands of files are practical before Git itself slows down.Read 15 Oct 2026 · git-annex.branchable.com
Scale
The project says file size is limited by the filesystem, while repositories with hundreds of thousands of files are supported and larger repositories may slow down due to git limitations.Read 4 Oct 2026 · git-annex.branchable.com
Security disclosure
The security page lists known vulnerabilities and fixes, and directs private vulnerability reports to the contact page.Read 4 Oct 2026 · git-annex.branchable.com
Security history
The security page records fixes for multiple historical vulnerabilities, including private-data exfiltration, malicious remote decryption and SSH hostname handling.Read 15 Oct 2026 · git-annex.branchable.com
Source build
A minimal Cabal build omits the assistant, webapp, pairing, D-Bus and magic-mime components, while a full build needs libraries such as libmagic and zlib.Read 15 Oct 2026 · git-annex.branchable.com
Special remotes
Built-in remotes include S3, Glacier, rsync, rclone, WebDAV, BitTorrent, Tor, git-lfs, adb, directory and p2p backends.Read 15 Oct 2026 · git-annex.branchable.com
Standalone builds
Linux standalone archives target x86, x86-64, ARM and ARM64 and are designed to have very few dependencies.Read 15 Oct 2026 · git-annex.branchable.com
Storage model
Git stores filenames and metadata while file contents live in a distributed key-value store under .git/annex, with location information recorded in a git-annex branch.Read 15 Oct 2026 · git-annex.branchable.com
Support model
Support is community-based through the forum, IRC and mailing list rather than a commercial support desk.Read 15 Oct 2026 · git-annex.branchable.com
Transfer resilience
Interrupted transfers can be resumed and bandwidth use can be adjusted to available capacity.Read 15 Oct 2026 · git-annex.branchable.com
Transfers
git-annex can resume interrupted file transfers.Read 4 Oct 2026 · git-annex.branchable.com

Plans and prices

git-annex Free Free Software; no paid tiers stated Read 15 Oct 2026 · git-annex.branchable.com

Every git-annex plan and price →

Strong points and limits

Strong points

  • Keeps file contents outside Git while tracking metadata.
  • Can resume interrupted transfers.
  • Supports online and offline data workflows.
  • Includes S3, Glacier, rclone, and WebDAV remotes.
  • Install instructions cover Linux, macOS, Android, and Windows.

Limits

  • Not a backup system by itself.
  • Encryption is mostly not used by default.
  • Larger repositories may slow down due to Git limitations.

Who it suits

It suits Git users comfortable with the command line who need to manage large files across repository clones and storage remotes. The assistant also supports synchronized folders across computers, Android devices, removable drives, NAS appliances, and cloud services.

Verdict

git-annex lays out its storage model, supported remotes, and scale caveats clearly. It can be part of archival or backup workflows, but the project does not present it as a backup system.

Where Specifiction places it

Alternatives to git-annexAll alternatives →