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.20221103 released with these changes

  • Doubled the speed of git-annex drop when operating on many files, and of git-annex get when operating on many tiny files.
  • trust, untrust, semitrust, dead: Fix behavior when provided with multiple repositories to operate on.
  • trust, untrust, semitrust, dead: When provided with no parameters, do not operate on a repository that has an empty name.
  • move: Fix openFile crash with -J (Fixes a reversion in 8.20201103)
  • S3: Speed up importing from a large bucket when fileprefix= is set, by only asking for files under the prefix.
  • When importing from versioned remotes, fix tracking of the content of deleted files.
  • More robust handling of ErrorBusy when writing to sqlite databases.
  • Avoid hanging when a suspended git-annex process is keeping a sqlite database locked.
  • Make --batch mode handle unstaged annexed files consistently whether the file is unlocked or not. Note that this changes the behavior of --batch when it is provided with locked files that are in the process of being added to the repository, but have not yet been staged in git.
  • Make git-annex enable-tor work when using the linux standalone build.
Posted Thu Nov 3 18:08:32 2022

git-annex 10.20221003 released with these changes

  • Avoid displaying warning about git-annex restage needing to be run in situations where it does not.
  • Fix the annex.adviceNoSshCaching config, which has never worked. Thanks, Reiko Asakura
Posted Mon Oct 3 17:24:36 2022

git-annex 10.20220927 released with these changes

  • Fix a bug in the last release that caused v8 repositories to upgrade immediately to v10, rather than taking the scheduled 1 year to do so.
  • annex.diskreserve default increased from 1 mb to 100 mb.
  • Include the assistant and webapp when building with cabal
  • Merged the webapp build flag into the assistant build flag.
  • Optimise linker in linux standalone tarballs.
  • Fix crash importing from a directory special remote that contains a broken symlink.
  • When accessing a git remote over http needs a git credential prompt for a password, cache it for the lifetime of the git-annex process, rather than repeatedly prompting.
  • Use curl for downloads from git remotes when annex.url-options is set.
  • Fix a reversion that made dead keys not be skipped when operating on all keys via --all or in a bare repo. (Introduced in version 8.20200720)
  • vicfg: Include mincopies configuration.
  • Improve handling of directory special remotes with importtree=yes whose ignoreinode setting has been changed. When getting a file from such a remote, accept the content that would have been accepted with the previous ignoreinode setting.
  • directory, adb: Fixed a bug with importtree=yes and multiple files in the special remote have the same content, that caused it to refuse to get a file from the special remote, incorrectly complaining that it had changed, due to only accepting the inode+mtime of one file (that was since modified or deleted) and not accepting the inode+mtime of other duplicate files.
  • Fix a reversion that prevented git-annex from working in a repository when --git-dir or GIT_DIR is specified to relocate the git directory to somewhere else. (Introduced in version 10.20220525)
  • Improved handling of --time-limit when combined with -J
  • Fix updating git index file after getting an unlocked file when annex.stalldetection is set.
  • restage: New git-annex command, handles restaging unlocked files.
  • test: Added --test-with-git-config option.
  • Run annex.freezecontent-command and annex.thawcontent-command when on a crippled filesystem. Thanks, Reiko Asakura
  • enable-tor: Fix breakage caused by git's fix for CVE-2022-24765.
  • Let GIT_DIR and --git-dir override git's protection against operating in a repository owned by another user.
  • p2p: Pass wormhole the --appid option before the receive/send command, as it does not accept that option after the command
  • Support "inbackend" in preferred content expressions.
Posted Tue Sep 27 17:32:12 2022

git-annex 10.20220822 released with these changes

  • v8 repositories now automatically upgrade to v9, which will in turn automatically upgrade to v10 in a year's time. To avoid this upgrade, you can set annex.autoupgraderepository to false.
  • Now uses v10 by default for new repositories.
  • Fix a regression in 10.20220624 that caused git-annex add to crash when there was an unstaged deletion.
  • Added new matching options --want-get-by and --want-drop-by.
  • Allow find --branch to be used in a bare repository, the same as the deprecated findref can be.
  • add --dry-run: New option.
  • import: Avoid following symbolic links inside directories being imported.
  • Work around bug in git 2.37 that causes a segfault when core.untrackedCache is set, which broke git-annex init.
  • Added annex.dbdir config which can be used to move sqlite databases to a different filesystem than the git-annex repo, when the repo is on a filesystem that sqlite does not work well in.
  • Use curl when includes an url scheme not supported by git-annex internally, as long as is configured to allow using curl.
  • Improve output when storing to bup.
  • When bup split fails, display its stderr.
  • Avoid running multiple bup split processes concurrently, since bup is not concurrency safe.
  • Avoid starting an unnecessary number of git hash-object processes when concurrency is enabled.
Posted Mon Aug 22 16:08:26 2022

git-annex 10.20220724 released with these changes

  • filter-process: Fix a bug involving handling of empty files, that caused git to kill git-annex filter-process.
  • add: Fix reversion when adding an annex link that has been moved to another directory. (Introduced in version 10.20220624)
  • Added annex.alwayscompact setting which can be unset to speed up writes to the git-annex branch in some cases. See its documentation for important notes on when it's appropariate to use.
  • adb: Added configuration setting oldandroid=true to avoid using find -printf, which was first supported in Android around 2019-2020. This may need to be enabled for old android devices that used to work without it being set, since version 10.20220222 started using find -printf.
  • --backend is no longer a global option, and is only accepted by commands that actually need it.
  • Improve handling of parallelization with -J when copying content from/to a git remote that is a local path.
  • S3: Avoid writing or checking the uuid file in the S3 bucket when importtree=yes or exporttree=yes.
  • Fix a reversion that prevented --batch commands (and the assistant) from noticing data written to the journal by other commands.
  • Fix building with the Assistant build flag disabled but the Webapp build flag enabled.
Posted Mon Jul 25 18:07:42 2022

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