02 Feb 2010
Homebrew: OS X's Missing Package Manager
Managing software packages on unix is a giant pain. Most linux distributions are built around different ways to try to alleviate that pain. Over the years, there have been various attempts to create effective package managers for OS X. The two most popular efforts, Fink and MacPorts, but they certainly have their frustrations. In both cases, creating packages or portfiles can be complex and difficult.
What does it do?
Homebrew alleviates the drudgery and repetition of downloading and installing unix software packages on OS X. If you're sick of
./configure && make && make install, Homebrew can definitely help.
OS X already has two package managers: Fink and MacPorts. If one of those is working for you, great. But if you've been frustrated by them in the past, I strongly suggest you give Homebrew a try. It's very easy to create and edit formulae, and even to edit Homebrew itself, since the core is just a few hundred lines of Ruby code.
It doesn't impose external structure on you – the default is to install it to
/usr/local, but you can install it anywhere. Inside your Homebrew directory, software is installed into subdirectories inside Homebrew's cellar, like
Cellar/git/22.214.171.124/. After installation, Homebrew symlinks the software into the regular unix directories. If you want to hand-install a package or version that isn't officially part of Homebrew yet, they can happily co-exist in the same location.
That's usually not necessary, though, since formulae can install directly out of version control. If a package has a public git, svn, cvs, or mercurial repository, you can install the latest development version as often as you like with a simple
Installing packages is faster, too, because Homebrew also works hard to avoid package duplication. No more installing yet another version of Perl as a package dependency when you already have a working install of Perl built in to OS X.
Best of all, Homebrew has a basic philosophy that you shouldn't have to use sudo to install or manage software on your computer.
Okay, it sounds pretty great. How do I get it?
The first (and only) dependency that Homebrew has is the OS X Developer Tools, which are on the OS X installer disc, and can be downloaded from developer.apple.com.
Unless you have a reason not to, the easiest place to install Homebrew is in
/usr/local. You can do that in just a few steps on the command line:
# Take ownership of /usr/local so you don't have to sudo sudo chown -R `whoami` /usr/local # Fix the permissions on your mysql installation, if you have one sudo chown -R mysql:mysql /usr/local/mysql # Download and install Homebrew from github curl -L http://github.com/mxcl/homebrew/tarball/master | tar xz --strip 1 -C /usr/local
Once you've done that, you're good to go! Assuming
/usr/local/bin is in your PATH, feel free to try it out:
brew install wget brew info git
The Homebrew wiki also has more about integrating with RubyGems, CPAN, and Python's EasyInstall.
Keeping your copy of Homebrew up to date is easy:
brew install git brew update
Once you have git installed, you can just run
brew update anytime you want to pull down the latest formulae.
Creating a new formula is almost that easy. If Homebrew didn't have a formula for wget, you could create one like this:
brew create http://ftp.gnu.org/gnu/wget/wget-1.12.tar.bz2
After you save your formula, you can test it out with
brew install -vd wget, to enable verbose logging and debug mode. If you need help getting your formula working, there is more documentation on the Homebrew wiki. You can also learn by example from already existing formula, like git or flac.
You can check out lots of example formulae, and Homebrew's internals, by running
brew edit. The code is pretty straightforward. If you have questions, or are interested in future plans, the contributors to Homebrew tend to hang out in the #machomebrew channel on Freenode.
Once you have a working new formula, it's easy to create your own fork of Homebrew on github to push your new formula to, by using the github gem.
git add . git commit -m "Added a formula for wget" gem install json github github fork git push <your github username> mastergitx
After pushing your change to github, go to the Homebrew issue tracker and create a ticket with the subject “New formula:
Homebrew is a compelling alternative to MacPorts and Fink. Both the Homebrew core and all the formulae are written in ruby, so it's easy to add new packages or even new features. If you're looking for more control over the unix software you have installed on your Mac, or you've been frustrated by other package managers in the past, check it out. I think you'll be happily surprised.
This post was originally written for, and posted to, the Engine Yard Blog.