Richard Brady edited this page May 6, 2013 · 148 revisions

Homebrew installs the stuff you need that Apple didn’t.

Please note: Homebrew is not 1.0 yet. Generally it works well, but when it doesn’t we’d hope you report the bug. If it’s still broken at 1.0 you have our permission to throw a strop and make a big fuss.


Before you report a bug, run brew doctor to diagnose known issues. If the doctor can’t help then use this checklist to correctly report the bug and we’ll get it fixed.

However! Fixing build issues is easier than you think: try brew edit formula-name and see how you fare.


In short:

  1. Fork Homebrew.
  2. brew create http://example.com/foo-0.1.tar.gz
  3. git commit Library/Formula/foo.rb && git push
  4. Pull Request.

In long:

Community Forums


  • Homebrew 0.9.3 Superenv is here to save the day.
  • Homebrew 0.9 brew-tap lands.
  • Homebrew 0.8 has been released, including the “refactor” branch and some improved support for Fortran-based software.


A list of the awesome people who gave £5 or more to our Kickstarter.