admin/brew
1
0
Fork 0
Code Issues Packages Projects Releases 6 Wiki Activity
brew/share/doc/homebrew/Troubleshooting.md
Mike McQuaid 492391f5fe Don't require/recommend ownership of /usr/local. 
Apple reset this on every OS X major (and some minor) updates and it
always proves a painful and unnecessary step. Instead just check the
directories we actually care about are writable.

This may mean if these directories do not already exist (although they
are now created by the installed) that `brew link` will fail and require
manual intervention but this seems to be superior for both new and the
majority of existing users.
2016-09-09 08:06:37 +01:00

1.9 KiB
Raw Blame History

Troubleshooting

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

When creating a formula-related issue please include the link output by running:

brew gist-logs <formula>

Check for common issues

  • Run brew update (twice).
  • Run brew doctor and fix all the warnings (outdated Xcode/CLT and unbrewed dylibs are very likely to cause problems).
  • Read through the Common Issues.
  • If you’re installing something Java-related, maybe you need to install Java (brew cask install java)?
  • Check that Command Line Tools for Xcode (CLT) and/or Xcode are up to date.
  • If things fail with permissions errors, check the permissions of /usr/local's subdirectories. If you’re unsure what to do, you can cd /usr/local && sudo chown -R $(whoami) bin etc include lib sbin share var Frameworks.

Check to see if the issue has been reported

  • Check the issue tracker to see if someone else has already reported the same issue.
  • Make sure you check issues on the correct repository. If the formula that failed to build is part of a tap like homebrew/science or homebrew/dupes check there instead.

Create an issue

  1. Upload debugging information to a Gist:
  • If you had a formula error: run brew gist-logs <formula> (where <formula> is the name of the formula that failed to build).
  • If you encountered a non-formula bug: upload the output of brew config and brew doctor to a new Gist.
  1. Create a new issue titled "<formula name> failed to build on 10.x", where <formula name> is the name of the formula that failed to build, and 10.x is the version of OS X you are using and including the link output by brew gist-logs