Home

Getting Started

• Installing Homebrew
• FAQ
• Tips n' Tricks
• Gems, Eggs and Perl Modules.

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 reporting the bug will help us to get the issue fixed.

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.

How to Brew

• Formula Cookbook
• Acceptable Formula
• git-brew-101

Forums

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

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.