Troubleshooting

Run brew update twice and brew doctor before creating an issue!

This document will help you check for common issues and make sure your issue has not already been reported.

Check for common issues

Follow these steps to fix common problems:

Run brew update twice.
Run brew doctor and fix all the warnings (unbrewed headers and shared libraries in /usr/local are likely to cause problems).
Read through the Common Issues.

Search the issue tracker to see if someone else has already reported the same issue.
Make sure you search issues on the correct repository. If a formula that has failed to build is part of a non-homebrew-core tap check those issue trackers instead.

If your problem hasn't been solved or reported, then create an issue.

If your issue is a problem with a single formula, please report your issue to Linuxbrew/homebrew-core. Linuxbrew is a fork of Homebrew. If you believe your issue is specific to Linux, please report your issue to Linuxbrew/brew. If you believe your issue is specific to Homebrew, but not specific to Linux, please report your issue to Homebrew/brew. If in doubt, please report the issue to Linuxbrew.

If you had a formula-related problem: run brew gist-logs <formula> (where <formula> is the name of the formula).
If you encountered a non-formula problem: upload the output of brew config and brew doctor to a new Gist.

Give your issue a descriptive title which includes the formula name (if applicable). For example, if a formula fails to build, title your issue formula: error: ..., where formula is the name of the formula that failed to build, and error: ... is the error message you saw, for example gzip: error: /usr/include/zlib.h: No such file or directory
Include the URL output by brew gist-logs <formula> (if applicable).
Include links to any additional Gists you may have created (such as for the output of brew config and brew doctor).