Published on June 14, 2012
This outline for building and installing Git has been tested against Mac OS X 10.7.x (and some more recent versions of OS X with minor tweaks). While these steps may work for previous versions of Mac OS X, I cannot confirm this. Furthermore, you’re on your own, if you screw something up, it’s not my fault.
Xcode includes the Git binary at the application level so it’s available to itself (located at
/Applications/Xcode.app/Contents/Developer/usr/bin/git). Additionally, Xcode includes a new “Downloads” preference pane to install optional components, one of which are the Command Line Tools (similar to the Dev Tools package that shipped with older versions of Xcode) and once installed, Git (and many other utilities, such as
make) is installed at the system level (located at
Note: You don’t have to install Xcode to use the Command Line Tools; it can be downloaded independently from the Apple Developer site (you need to login, but it’s free).
Now, because the the Git binary provided by Apple is placed in
/usr/bin you need to make sure your
$PATH environment variable is setup properly (see below) and that you install your own build of Git into
/usr/local/bin for two reasons:
/usr/binwhenever Xcode and/or the Command Line Tools are updated.
/usr/binis in the
$PATHvariable BEFORE the location where you install your own build of the Git binary (I’m suggesting
/usr/local/bin/git) then the Apple binary located at
/usr/bin/gitwill always be used when the git command is run.
Unfortunately, Apple doesn’t make managing the
$PATH environment variable easy – there are nearly a dozen ways this variable can be set or changed. I’ve done plenty of digging on this topic over the years, and here’s the skinny (to my knowledge) listed in order of operation:
/etc/profile(interactive login shell, or as a non-interactive shell with the
--loginoption, if exists)
/usr/libexec/path_helperbeing called from
/usr/libexec/path_helperbeing * called from
/etc/profile, if exists)
~/.bashrc(optional, usually sourced from
.bash_profile, if exists)
.bash_profiledoes not exist)
.bash_logindoes not exist)
loginwindow, useful for paths needed by CLI daemons)
It’s easy to get all twisted up here, but all you need to do is ensure
/usr/local/bin is in the
$PATH variable BEFORE
/usr/bin. For me that simply meant reordering the directories listed in
/etc/paths to the following, ensuring
/usr/local/bin is first:
/usr/local/bin /usr/bin /usr/sbin /bin /sbin
Note: When making
$PATH changes, you’ll likely need to restart your console session (either a new window or a new tab) to test/verify your changes (which is as easy as
$ echo $PATH).
There are two ways to do this, the first uses Git (if you’ve installed Command Line Tools, either with or without Xcode) and the second simply downloads a compressed archive of the files needed from the Google project page.
Note: I prefer to do this in a permanent location as you can easily do a
git pull and switch to the latest tag in the repository, at a future date, and run through the build steps again to install a newer version of the binary.
$ git clone git://github.com/gitster/git.git $ cd git $ git fetch $ git tag -v v126.96.36.199 # verify latest stable tag $ git checkout v188.8.131.52 # checkout latest stable tag
$ curl -O http://git-core.googlecode.com/files/git-184.108.40.206.tar.gz # download the latest stable from [Google code](http://code.google.com/p/git-core/downloads/list) $ tar -xzvf git-220.127.116.11.tar.gz $ cd git-18.104.22.168
$ make configure # this is optional, requires GNU Autoconf be installed $ ./configure --prefix=/usr/local # you can only run this if you've run the command above $ make prefix=/usr/local $ sudo make prefix=/usr/local install
A whole separate mission is getting the Git documentation to build on OS X. For the sake of time, here are the steps, and if anyone decides to dive in, feel free to ping me with questions on how I did it.
$ make prefix=/usr/local doc $ sudo make prefix=/usr/local install-doc
If you’re lazy (I wasn’t, however I didn’t learn about this “alternative” method until AFTER going through the steps above) there’s a MUCH easier way to install the Git documentation:
$ cd .. # the directory where you cloned the git repo (not into the git repo directory, but it's parent) $ git clone https://github.com/gitster/git-manpages.git $ cd git $ make prefix=/usr/local $ sudo make quick-install-man
git-credential-osxkeychainfor OS X keychain integration
If the osxkeychain helper isn’t installed and you’re running OS X version 10.9 or above, running
git credential-osxkeychain will prompt you to download it as a part of the Xcode Command Line Tools.
Alternatively, if running that command displays
git: 'credential-osxkeychain' is not a git command. See 'git --help' you may need to install it manually:
$ curl -s -O http://github-media-downloads.s3.amazonaws.com/osx/git-credential-osxkeychain $ chmod u+x git-credential-osxkeychain $ sudo mv git-credential-osxkeychain "$(dirname $(which git))/" $ git config --global credential.helper osxkeychain
This isn’t for the faint of heart. If you skipped to down here, you should probably just download the Git OS X Installer package (generally one maintenance release behind latest), or use MacPorts or Homebrew both of which are current to the latest stable release of Git.