git-annex/doc/install/OSX.mdwn

## git-annex.app

For easy installation, [Jimmy Tang](http://www.sgenomics.org/~jtang/)
builds a standalone git-annex.app of the git-annex assistant.

* [beta release of git-annex.app](http://downloads.kitenet.net/git-annex/OSX/git-annex.dmg.bz2)
* [daily build of git-annex.app](http://www.sgenomics.org/~jtang/gitbuilder-git-annex-x00-x86_64-apple-darwin10.8.0-binary/ref/master/git-annex.dmg.bz2) ([build logs](http://www.sgenomics.org/~jtang/gitbuilder-git-annex-x00-x86_64-apple-darwin10.8.0-binary/))
  * [past builds](http://www.sgenomics.org/~jtang/gitbuilder-git-annex-x00-x86_64-apple-darwin10.8.0-binary/sha1/) -- directories are named from the commitid's

## using Brew

<pre>
sudo brew update
sudo brew install haskell-platform git ossp-uuid md5sha1sum coreutils pcre adns libgsasl
cabal update
cabal install git-annex --bindir=$HOME/bin
</pre>

## using MacPorts

Install the Haskell Platform from [[http://hackage.haskell.org/platform/mac.html]].
The version provided by Macports is too old to work with current versions of git-annex.
Then execute

<pre>
sudo port install git-core ossp-uuid md5sha1sum coreutils pcre

sudo ln -s /opt/local/include/pcre.h  /usr/include/pcre.h # This is hack that allows pcre-light to find pcre

sudo cabal update
cabal install git-annex --bindir=$HOME/bin
</pre>

## PATH setup

Do not forget to add to your PATH variable your ~/bin folder. In your .bashrc, for example:
<pre>
PATH=~/bin:/usr/bin/local:$PATH
</pre>

See also:

* [[forum/OSX__39__s_haskell-platform_statically_links_things]]
* [[forum/OSX__39__s_default_sshd_behaviour_has_limited_paths_set]]