git-annex.app
For easy installation, use the prebuilt app bundle.
- 10.15 Catalina: git-annex.dmg
To run the git-annex assistant, just install the app, look for the icon, and start it up.
To use git-annex at the command line, you can add
git-annex.app/Contents/MacOS to your PATH
Alternatively, from the command line you can run
git-annex.app/Contents/MacOS/runshell, which makes your shell use all the
programs bundled inside the app, including not just git-annex, but git, and
several more. Handy if you don't otherwise have git installed.
autobuilds
An autobuild is also available, thanks to the Datalad project.
download security
All the download links above use https for security. For added security, see verifying downloads.
using Homebrew
git-annex is available in Homebrew.
using MacPorts
git-annex is not available in MacPorts, but can be built from source using MacPorts tools. See MacPorts.
building it yourself
See porting.
I've moved some outdated comments about installing on OSX to old comments. And also moved away some comments that helped build the instructions above.
Hi,
Are there plans to provide a git-annex.app that works on Snow Leopard?
Currently there are only installers for the Lions.
http://downloads.kitenet.net/git-annex/OSX/current/
Thanks
I have fiddled with the fresh (as of Oct 2nd) build of assistant on OS X 10.8.5, and there has been a lot of problems with bundled software
bundled git is an old 1.7.x version which keeps saying in the daemon logs it is too old to honor .gitignores etc at the same time I have git 1.8.4 installed through homebrew which works very nicely throughout my system
I also have homebrew-installed gpg2:
$ gpg2 --version gpg (GnuPG) 2.0.21 libgcrypt 1.5.3
(and have briefly experimented with using GPGSuite from gpgtools.org, which kept bailing with invalid autolocate directive in gpg.conf)
however there is some unidentifiable gpg binary bundled with the assistant, which cannot connect to gpg-agent from gpg2, and doesn't work with GPGSuite (see above)
is there a way to completely forgo usage of bundled software and have the webapp use whatever is already available on the system?
@David, the bundle contains the man page since a while.
@Michael, the best way to get a git-annex that does not use those bundled programs is probably to instead install it using homebrew.
The Yosemite build linked above has been reported to work on Mavericks too, and is being updated. There is no separate Mavericks build anymore.
There were some old mavericks builds floating around the downloads site; I've removed those and symlinked the mavericks directory to the yosimite directory.
The OSX 10.10 build works fine on my 10.11 El Capitan machine. Updated this page to reflect that.
git-annex is also in 'brew cask', automating installation from the OSX binaries. I've sent PR 18105 to the brew cask team to get the cask to work for 10.11.
Just downloaded the DMG, copied the .app into /Applications and ran it; does nothing, from terminal:
$ open -W /Applications/git-annex.app The application cannot be opened because its executable is missing.
$ /Applications/git-annex.app/Contents/MacOS/git-annex-webapp $ unable to start webapp in repository /Users/lhunath/annex: Not in a git repository. Launching web browser on file:///var/folders/np/v9byg9092bbf31jw5cydzszm0000gn/T/webapp1622650073984943658.html
$ /Applications/git-annex.app/Contents/MacOS/git-annex version git-annex version: 6.20160427-gd0036b9 build flags: Assistant Webapp Pairing Testsuite S3(multipartupload)(storageclasses) WebDAV FsEvents XMPP ConcurrentOutput TorrentParser MagicMime Feeds Quvi key/value backends: SHA256E SHA256 SHA512E SHA512 SHA224E SHA224 SHA384E SHA384 SHA3_256E SHA3_256 SHA3_512E SHA3_512 SHA3_224E SHA3_224 SHA3_384E SHA3_384 SKEIN256E SKEIN256 SKEIN512E SKEIN512 SHA1E SHA1 MD5E MD5 WORM URL remote types: git gcrypt S3 bup directory rsync web bittorrent webdav tahoe glacier ddar hook external
I don't know what needs to be put where in the app to make
openrun git-annex-webapp. There is already a Info.plist file that I thought was supposed to handle that. If someone wants to help makeopenwork please be my guest.On macOS High Sierra (10.13.3) trying to use git-annex from the latest .dmg shows the following error:
I ran it by opening the .app directory (Show Package Contents) and running the
runshellscript to set up the environment:@achilleas.k, that was this bug which should be fixed now.
Please file bug reports for issues with the OSX build, don't report them here.
brew install git-annexsee Homebrew.Guys talking about uname -o and stuff, this is not the place to do that. File a ?bug report if you have a bug like that. You're making it harder for every person who opens this page to install git-annex and ends up wwading through discussion of fixed bugs like that one. Also, I respond much faster to bug reports than to random misplaced comments about bugs.
@Dan I would not be surprised if cabal v2-install does not support installing man pages like the old v1-install does. When I tried it, it seemed not to.
The Makefile has an
install-manstarget that could be used instead. There are several other things thatmake installdoes that cabal cannot, including installing completions files, so system integrators (like homebrew) should probably use it when they can.