Home

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

• Install Homebrew
• FAQ
• Tips n' Tricks
• Gems, Eggs and Perl Modules and Homebrew and Python

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.

Because Homebrew is continuously updated, it's important to revisit the documentation frequently. If something isn't working quite as you expected, check the history (and/or git log): it might be an intentional change.

h2. Troubleshooting

First, please run @brew update@ and @brew doctor@.

Second, please read the Troubleshooting Checklist.

If you don't read these it will take us far longer to help you with your problem.

However! Fixing build issues is easier than you think: try @brew edit $FORMULA@ and see how you fare.

h2. Contributing

In short:

"Fork Homebrew":https://github.com/Homebrew/homebrew/fork.

@brew create http://example.com/foo-0.1.tar.gz@

@git checkout -b foo@

@git commit Library/Formula/foo.rb && git push@

"Pull Request":https://github.com/Homebrew/homebrew/pulls.

In long:

• Formula Cookbook
• Acceptable Formulae
• "Ruby Style Guide":https://github.com/styleguide/ruby

h2. Community Forums

• "@MacHomebrew":https://twitter.com/MacHomebrew
• "[email protected]":mailto:[email protected] ("archive":http://librelist.com/browser/homebrew)
• "freenode.net#machomebrew":irc://irc.freenode.net/#machomebrew

h1. News

• 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.

h1. Supporters

"A list of the awesome people who gave £5 or more to our Kickstarter":https://github.com/Homebrew/homebrew/blob/master/SUPPORTERS.md.