This is where announcements of new releases, features, and other news is posted. git-annex users are recommended to subscribe to this page's RSS feed. Also, see security for security announcements.

RSS Atom Add a new post titled:

git-annex 10.20220504 released with these changes

  • Ignore annex.numcopies set to 0 in gitattributes or git config, or by git-annex numcopies or by --numcopies, since that configuration would make git-annex easily lose data. Same for mincopies.
  • assistant: When annex.autocommit is set, notice commits that the user makes manually, and push them out to remotes promptly.
  • multicast: Support uftp 5.0 by switching from aes256-cbc to aes256-gcm.
  • Fix test failure on NFS when cleaning up gpg temp directory.
  • Fix a build failure with ghc 9.2.2. Thanks, gnezdo for the patch.
  • rsync 3.2.4 broke backwards-compatability by preventing exposing filenames to the shell. Made the rsync and gcrypt special remotes detect this and disable shellescape. Closes: #1010397
  • repair: Avoid treating refs/annex/last-index or other refs that are not commit objects as evidence of repository corruption.
Posted Wed May 4 15:48:58 2022

git-annex 10.20220322 released with these changes

  • Directory special remotes with importtree=yes have changed to once more take inodes into account. This will cause extra work when importing from a directory on a FAT filesystem that changes inodes on every mount. To avoid that extra work, set ignoreinodes=yes when initializing a new directory special remote, or change the configuration of your existing remote: git-annex enableremote foo ignoreinodes=yes
  • add: Avoid unncessarily converting a newly unlocked file to be stored in git when it is not modified, even when annex.largefiles does not match it.
  • The above change to add fixes a reversion in version 10.20220222, where git-annex unlock followed by git-annex add, followed by git commit file could result in git thinking the file was modified after the commit.
  • Detect when an unlocked file whose content is not present has gotten some other content appended to it, and avoid treating it as a pointer file, so that appended content will not be checked into git, but will be annexed like any other file.
  • smudge: Warn when encountering a pointer file that has other content appended to it.
  • When annex.freezecontent-command is set, and the filesystem does not support removing write bits, avoid treating it as a crippled filesystem.
  • Run annex.thawcontent-command before deleting an object file, in case annex.freezecontent-command did something that would prevent deletion.
  • Fix propagation of nonzero exit status from git ls-files when a specified file does not exist, or a specified directory does not contain any files checked into git.
  • Fix build with aeson 2.0. Thanks, sternenseemann for the patch.
  • Avoid git-annex test being very slow when run from within the standalone linux tarball or OSX app.
  • test: Runs tests in parallel to speed up the test suite.
  • test: Added --jobs option.
  • Removed vendored copy of http-client-restricted, and removed the HttpClientRestricted build flag that avoided that dependency.
  • Removed the NetworkBSD build flag.
Posted Tue Mar 22 17:56:57 2022

git-annex 10.20220222 released with these changes

  • annex.skipunknown now defaults to false, so commands like git annex get foo* will not silently skip over files/dirs that are not checked into git.
  • info: Allow using matching options in more situations. File matching options like --include will be rejected in situations where there is no filename to match against.
  • adb: Avoid find failing with "Argument list too long"
  • Fix git-annex forget propagation between repositories. (reversion introduced in version 7.20190122)
  • registerurl, unregisterurl: Improved output when reading from stdin to be more like other batch commands.
  • registerurl, unregisterurl: Added --json and --json-error-messages options.
  • Avoid git status taking a long time after git-annex unlock of many files.
  • Pass --no-textconv when running git diff internally.
Posted Tue Feb 22 17:35:07 2022

git-annex 10.20220127 released with these changes

  • New v10 repository version (with v9 as a stepping-stone to it). v8 remains the default version for now.
  • In v10, object files are locked using separate lock files. This allows the object files to be kept non-writable even in repositories where core.sharedRepository is set.
  • The v10 upgrade will happen automatically, one year after the v9 upgrade, in order to allow time for any old git-annex processes that are not aware of the locking change to finish. Or git-annex upgrade can be used to upgrade to v10 immediately.
  • In v9 upgrade, set filter.annex.process. This makes git add/checkout faster when there are a lot of unlocked annexed files or non-annexed files, but can also make git add of large files to the annex somewhat slower. If this tradeoff does not work for your use case, you can still unset filter.annex.process.
  • export: When a non-annexed symlink is in the tree to be exported, skip it.
  • import: When the previously exported tree contained a non-annexed symlink, preserve it in the imported tree so it does not get deleted.
  • enableremote, renameremote: Better handling of the unusual case where multiple special remotes have been initialized with the same name.
  • Recover from corrupted content being received from a git remote, by deleting the temporary file when it fails to verify. This prevents a retry from failing again. (reversion introduced in version 8.20210903)
  • adb: Added ignorefinderror configuration parameter.
  • Avoid crashing when run in a bare git repo that somehow contains an index file.
  • Reject combinations of --batch (or --batch-keys) with options like --all or --key or with filenames.
Posted Thu Jan 27 18:54:22 2022

git-annex 8.20211231 released with these changes

  • Improved support for using git-annex in a read-only repository, git-annex branch information from remotes that cannot be merged into the git-annex branch will now not crash it, but will be merged in memory.
  • addurl, youtube-dl: When --check-raw prevents downloading an url, still continue with any downloads that come after it, rather than erroring out.
  • Fix locking problems when annex.pidlock is set and concurrency is enabled eg with -J.
  • Improve error message display when autoinit fails due to eg, a permissions problem.
  • export: Avoid unncessarily re-exporting non-annexed files that were already exported.
  • Improve git command queue flushing so that eg, addurl of several large files that take time to download will update the index for each file, rather than deferring the index updates to the end.
  • sync: Better error message when unable to export to a remote because is configured to a ref that does not exist.
  • Fix build with ghc 9.0.1
  • Fix build with old versions of feed library.
Posted Fri Dec 31 19:12:29 2021

Similar to the yearly git user survey, there is a 2018 git-annex user survey.

If you use git-annex, please take a few minutes to answer the questions!

Since git-annex is seeing increasing use to manage scientific data, the survey also includes some extra questions about that at the end.

Posted Sat Dec 1 15:46:38 2018

git-annex 6.20180626 is an important security fix release.

See the advisory for details about the security holes fixed in this release.

After upgrading git-annex, you should restart any git-annex assistant processes.

Several changes to git-annex's behavior had to be made as part of the security fixes:

  • A security fix has changed git-annex to refuse to download content from some special remotes when the content cannot be verified with a hash check. In particular URL and WORM keys stored on such remotes won't be downloaded. See the documentation of the configuration for how to deal with this if it affects your files.

  • A security fix has changed git-annex to only support http, https, and ftp URL schemes by default. You can enable other URL schemes, at your own risk, using

  • A related security fix prevents git-annex from connecting to http servers (and proxies) on localhost or private networks. This can be overridden, at your own risk, using

  • Setting annex.web-options no longer is enough to make curl be used, and youtube-dl is also no longer used by default. See the documentation of for details and how to enable them.

  • The annex.web-download-command configuration has been removed, use annex.web-options instead.

Posted Tue Jun 26 16:00:19 2018

Similar to the yearly git user survey, there is a 2015 git-annex user survey.

If you use git-annex, please take a few minutes to answer the questions!

Posted Mon Oct 19 20:05:12 2015

Similar to the yearly git user survey, I am doing a 2013 git-annex user survey.

If you use git-annex, please take a few minutes to answer my questions!

Posted Fri Nov 22 17:17:21 2013

Thanks to my recent successful git-annex crowdfunding campaign, $1000 has been set aside to award others for their contributions to git-annex by the end of 2013. This is not a lot of money, but I hope that the reward and recognition will encourage some more people to work on git-annex.

You don't need to know Haskell! You could contribute some interesting and useful special remote hooks, or write better documentation.

On the other hand, if you have learned Haskell, this might be your first chance to make some money with it! Some ideas for things to work on that would be particularly award-worthy:

  • Port git-annex to IOS, using ghc-ios. I don't plan to ever do this myself, but you could make it happen.
  • Get the git-annex assistant working in Windows, building on the existing port to Windows. Otherwise, this is on my roadmap for February.
  • Solve existing bugs or todo items. There are more than I can keep up with.

The amount of the awards will vary depending on the size of the contribution. Since this is getting started later than is ideal, I reserve the right to extend it past the end of the year if I don't get enough participants.

If you'd like to participate in this program, just email me at --Joey

Posted Thu Oct 10 22:02:33 2013

git-annex will be briefly presented at FOSDEM, on Sunday February 4th at 15:40. Details.

Thanks to Richard Hartmann for making this presentation.

Posted Sat Feb 4 18:30:28 2012

Christophe-Marie Duquesne has just announced Sharebox, a FUSE filesystem relying on git-annex:

What are your goals?  
Seamless synchronization "à la dropbox".  
Ability to use with big binary files such as mp3/movies.  
Entirely decentralized.  
Don't use unnecessary space  
Keep it simple: avoid special VCS commands and keep a filesystem  
interface as much as possible.

While still alpha, this is promising. --Joey

Posted Thu Mar 31 18:06:14 2011

Linux Weekly News has a nice article on git-annex in it this week.

Posted Thu Dec 9 15:35:07 2010