git-annex/doc/install/OSX.mdwn
2021-07-02 13:01:24 -04:00

37 lines
1.3 KiB
Markdown

## git-annex.app
[[!img /assistant/osx-app.png align=right link=/assistant]]
For easy installation, use the prebuilt app bundle.
* 10.11 El Capitan / 10.10 Yosemite / 10.9 Mavericks: [git-annex.dmg](https://downloads.kitenet.net/git-annex/OSX/current/10.10_Yosemite/git-annex.dmg)
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
An autobuild is also available, thanks to the Datalad project.
* [git-annex.dmg](https://downloads.kitenet.net/git-annex/autobuild/x86_64-apple-catalina/git-annex.dmg)
([build logs](https://github.com/datalad/git-annex/actions/workflows/build-macos.yaml?query=Build+git-annex+on+macOS))
## using Homebrew
git-annex is [[available in Homebrew|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]].