Skip to content
secondplanet edited this page Jun 5, 2011 · 108 revisions

Homebrew is the easiest and most flexible way to install the UNIX tools Apple didn’t include with OS X. Please head over to the instructions, to get you started.

Homebrew doesn’t install gems, etc., if you want them, you should read this: Gems, Eggs and Perl Modules

More questions? Maybe the FAQ can help.

Report Bugs

If you encounter errors, please report them over at the tracker. To make sure you submit a good report, a good start can be to read “How To File A Bug Report”.

Dealing With the Terror of Errors

Something just blow up? A formula not working correctly? We have a checklist that can help resolve most problems.

Words about Homebrew

Find a nice blog entry on using Homebrew and link it here.

Contributing Formulae

To contribute a formula: fork, clone, create, audit, commit, push and then create a pull request (from a new branch, not master). Please read the Formula Cookbook before your first contribution or you’ll make us cry.

Remember! We don’t accept formulae into mxcl/master that dupes stuff already included with OS X. More details on that in the Formula Cookbook.

Extending Homebrew

Either fork, add features, commit, push and open a ticket or create a new external command.

Arenas for Discussion

IRC (irc://irc.freenode.net/#machomebrew)
Mailing List ([email protected])
Twitter (http://twitter.com/machomebrew)

News

  • Homebrew 0.8 has been released, including the “refactor” branch and some improved support for Fortran-based software.
Clone this wiki locally