Instructions for a supported install of Homebrew are on the homepage.
This script installs Homebrew to its preferred prefix (
/usr/local for macOS Intel,
/opt/homebrew for Apple Silicon and
/home/linuxbrew/.linuxbrew for Linux) so that you don’t need sudo when you
brew install. It is a careful script; it can be run even if you have stuff installed in the preferred prefix already. It tells you exactly what it will do before it does it too. You have to confirm everything it will do before it starts.
xcode-select --installor https://developer.apple.com/download/all/) or Xcode 3
You can use geolocalized Git mirrors to speed up Homebrew’s installation and
brew update by setting
HOMEBREW_CORE_GIT_REMOTE in your shell environment with this script:
export HOMEBREW_BREW_GIT_REMOTE="..." # put your Git mirror of Homebrew/brew here export HOMEBREW_CORE_GIT_REMOTE="..." # put your Git mirror of Homebrew/homebrew-core here /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
The default Git remote will be used if the corresponding environment variable is unset.
Just extract (or
git clone) Homebrew wherever you want. Just avoid:
/tmpsubdirectories because Homebrew gets upset.
/opt/localbecause build scripts get confused when Homebrew is there instead of Fink or MacPorts, respectively.
However do yourself a favour and use the installer to install to the default prefix. Some things may not build when installed elsewhere. One of the reasons Homebrew just works relative to the competition is because we recommend installing here. Pick another prefix at your peril!
mkdir homebrew && curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C homebrew
git clone https://github.com/Homebrew/brew homebrew
eval "$(homebrew/bin/brew shellenv)" brew update --force --quiet chmod -R go-w "$(brew --prefix)/share/zsh"
Create a Homebrew installation wherever you extract the tarball. Whichever
brew command is called is where the packages will be installed. You can use this as you see fit, e.g. to have a system set of libs in the default prefix and tweaked formulae for development in
If you want a non-interactive run of the Homebrew installer that doesn’t prompt for passwords (e.g. in automation scripts), prepend
NONINTERACTIVE=1 to the installation command.
Uninstallation is documented in the FAQ.
3 Most formulae require a compiler. A handful require a full Xcode installation. You can install Xcode, the CLT, or both; Homebrew supports all three configurations. Downloading Xcode may require an Apple Developer account on older versions of Mac OS X. Sign up for free at Apple’s website.