git-annex/doc/install/OSX.mdwn

## git-annex.app

[[!img /assistant/osx-app.png align=right link=/assistant]]
For easy installation, use the prebuilt app bundle.

* 10.9 Mavericks: [git-annex.dmg](https://downloads.kitenet.net/git-annex/OSX/current/10.9_Mavericks/git-annex.dmg)
* 10.8.2 Mountain Lion: [git-annex.dmg.bz2](https://downloads.kitenet.net/git-annex/OSX/current/10.8.2_Mountain_Lion/git-annex.dmg.bz2) **warning: not being updated any longer**
* 10.7.5 Lion: [git-annex.dmg](https://downloads.kitenet.net/git-annex/OSX/current/10.7.5_Lion/git-annex.dmg) **warning: not being updated any longer**

To run the [[git-annex_assistant|/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

[[Joey]] autobuilds the app for Mavericks.

* [autobuild of git-annex.dmg](https://downloads.kitenet.net/git-annex/autobuild/x86_64-apple-mavericks/git-annex.dmg) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/x86_64-apple-mavericks/))

## using Brew

<pre>
brew update
brew install haskell-platform git ossp-uuid md5sha1sum coreutils gnutls libidn gsasl pkg-config libxml2
brew link libxml2 --force
cabal update
mkdir $HOME/bin
PATH=$HOME/bin:$PATH
PATH=$HOME/.cabal/bin:$PATH
cabal install c2hs --bindir=$HOME/bin
cabal install gnuidn
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 gnutls libxml2 libgsasl pkgconfig
sudo cabal update
PATH=$HOME/bin:$PATH
cabal install c2hs 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=$HOME/bin:$PATH
</pre>

See also:

* [[forum/OSX__39__s_haskell-platform_statically_links_things]]
* [[forum/OSX__39__s_default_sshd_behaviour_has_limited_paths_set]]
add links to git-annex.app builds 2012-09-27 22:52:42 +00:00			`## git-annex.app`

link 2013-03-19 18:16:42 +00:00			`[[!img /assistant/osx-app.png align=right link=/assistant]]`
mavericks 2013-11-14 18:18:29 +00:00			`For easy installation, use the prebuilt app bundle.`
add links to git-annex.app builds 2012-09-27 22:52:42 +00:00
urls 2013-11-18 15:11:50 +00:00			`* 10.9 Mavericks: [git-annex.dmg](https://downloads.kitenet.net/git-annex/OSX/current/10.9_Mavericks/git-annex.dmg)`
format 2013-11-14 18:38:08 +00:00			`* 10.8.2 Mountain Lion: [git-annex.dmg.bz2](https://downloads.kitenet.net/git-annex/OSX/current/10.8.2_Mountain_Lion/git-annex.dmg.bz2) warning: not being updated any longer`
no more OSX lion builds 2014-01-06 15:32:23 +00:00			`* 10.7.5 Lion: [git-annex.dmg](https://downloads.kitenet.net/git-annex/OSX/current/10.7.5_Lion/git-annex.dmg) warning: not being updated any longer`
OSX Mountian Lion builds now available 2012-12-17 16:59:18 +00:00
mavericks 2013-11-14 18:18:29 +00:00			`To run the [[git-annex_assistant\|/assistant]], just`
add OSX runshell documentation 2013-03-19 18:12:47 +00:00			`install the app, look for the icon, and start it up.`

reorganize osx app, so it can be put in PATH Move all the binaries and libraries under a bundle/ subdirectory; so when it's in PATH only git-annex, runshell, and git-annex-webapp will be available. 2013-03-20 18:01:05 +00:00			`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.`
add OSX runshell documentation 2013-03-19 18:12:47 +00:00
OSX Mountian Lion builds now available 2012-12-17 16:59:18 +00:00			`## autobuilds`
add links to git-annex.app builds 2012-09-27 22:52:42 +00:00
mavericks 2013-11-14 18:18:29 +00:00			`[[Joey]] autobuilds the app for Mavericks.`
new autobuilder 2012-12-17 23:47:39 +00:00
rename 2013-11-18 03:08:05 +00:00			`* [autobuild of git-annex.dmg](https://downloads.kitenet.net/git-annex/autobuild/x86_64-apple-mavericks/git-annex.dmg) ([build logs](https://downloads.kitenet.net/git-annex/autobuild/x86_64-apple-mavericks/))`
new autobuilder 2012-12-17 23:47:39 +00:00
add brew section to osx page and move away comments obsoleted by this change 2012-09-24 21:08:22 +00:00			`## using Brew`

			`<pre>`
sudo should not be used with homebrew 2012-12-26 01:34:47 +00:00			`brew update`
Changed to the brew script: libgsasl has been removed in favor of gsasl, also libgsasl was listed twice. See https://github.com/Homebrew/homebrew/pull/16428 for more info. 2013-12-14 17:59:50 +00:00			`brew install haskell-platform git ossp-uuid md5sha1sum coreutils gnutls libidn gsasl pkg-config libxml2`
force link of libxml2 seems necessary now 2013-07-27 17:50:10 +00:00			`brew link libxml2 --force`
add brew section to osx page and move away comments obsoleted by this change 2012-09-24 21:08:22 +00:00			`cabal update`
add a step to make sure that $HOME/bin exists - this tripped me up. 2013-07-08 07:20:04 +00:00			`mkdir $HOME/bin`
improve cabal instructions to handle installing c2hs 2012-12-09 15:51:45 +00:00			`PATH=$HOME/bin:$PATH`
Added cabal bin path for brew 2013-06-10 19:00:33 +00:00			`PATH=$HOME/.cabal/bin:$PATH`
2013-06-11 19:04:17 +00:00			`cabal install c2hs --bindir=$HOME/bin`
Added a step I had to do on my own OS X machine with 10.6 in order for the build to work. 2013-05-25 18:36:37 +00:00			`cabal install gnuidn`
2013-06-11 19:04:17 +00:00			`cabal install git-annex --bindir=$HOME/bin`
add brew section to osx page and move away comments obsoleted by this change 2012-09-24 21:08:22 +00:00			`</pre>`

			`## using MacPorts`

simplify OSX installation instructions The new Haskell Platform was released today, with the new ghc git-annex's master branch needs, so cabal should be usable again on OSX. 2012-06-03 18:27:11 +00:00			`Install the Haskell Platform from [[http://hackage.haskell.org/platform/mac.html]].`
update OSX instructions to use ghc7.0 branch Needed until the next Haskell Platform provides a new ghc. 2012-05-28 19:07:32 +00:00			`The version provided by Macports is too old to work with current versions of git-annex.`
			`Then execute`
2011-07-30 17:28:42 +00:00
reord install pages; per-OS instructions 2011-02-06 17:43:31 +00:00			`<pre>`
Now uses the Haskell Glob library, rather than pcre-light, avoiding the need to install libpcre. Currently done only for Cabal or when the Makefile is made to use -DWITH_GLOB 2013-02-11 15:47:53 +00:00			`sudo port install git-core ossp-uuid md5sha1sum coreutils gnutls libxml2 libgsasl pkgconfig`
switch to using cabal-install git-annex 2011-09-06 18:48:15 +00:00			`sudo cabal update`
improve cabal instructions to handle installing c2hs 2012-12-09 15:51:45 +00:00			`PATH=$HOME/bin:$PATH`
			`cabal install c2hs git-annex --bindir=$HOME/bin`
reord install pages; per-OS instructions 2011-02-06 17:43:31 +00:00			`</pre>`

add brew section to osx page and move away comments obsoleted by this change 2012-09-24 21:08:22 +00:00			`## PATH setup`

Added PATH variable part 2012-08-24 18:22:07 +00:00			`Do not forget to add to your PATH variable your ~/bin folder. In your .bashrc, for example:`
			`<pre>`
improve cabal instructions to handle installing c2hs 2012-12-09 15:51:45 +00:00			`PATH=$HOME/bin:$PATH`
Added PATH variable part 2012-08-24 18:22:07 +00:00			`</pre>`

move OSX tips to forum and link to from install/OSX 2011-03-19 15:31:08 +00:00			`See also:`

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