Skip to content
mxcl edited this page Aug 9, 2012 · 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.

Reporting Bugs

Before you report your build-error, did you know Homebrew is totally, amazingly easy to hack? Just brew edit foo where foo is the formula you want to fix. It’s not rocket-science: try it out!

Run brew doctor first, it helps diagnose known issues. If that doesn’t help then we’ll fix it if you report the bug.

Brewing

Contributing to Homebrew is easy and encouraged!

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

Please note, we now have taps for certain categories of formula, ensure you submit to the right place!

If you are champing at the bit we have a list of outdated formulae.

If you plan to contribute formula, read this stuff:

Community Forums

News

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