webinstall.dev/brew Star on GitHub

To update or switch versions, use brew's built-in upgrade management, or our handy update service script:

brew update
brew upgrade
brew-update-service-install # Webi helper script

Files

These are the files / directories that are created and/or modified with this install:

~/.config/envman/PATH.env
~/.local/opt/brew/
~/.local/bin/brew-update-service-install

Cheat Sheet

Homebrew installs the stuff you need that Apple (or your Linux system) didn’t.

Important: This will install brew to ~/.local/opt/brew/, NOT /usr/local. The ability to install brew, without sudo, in your HOME directory is a relatively new feature. If you do encounter a brew install issue, report it to brew. way, report it to brew.

How to install CLI packages

brew update
brew install node

How to install GUI packages

brew update
brew cask install docker

Where are things installed?

~/.local/opt/brew/

For reference, traditional brew installs here:

/usr/local/Cellar/
/opt/homebrew-cask/Caskroom/

brew screwed up everything, now what?

Sometimes you're compelled against all reason to do something really stupid, like brew upgrade or brew update python, and your whole system gets borked.

If you need to uninstall and reinstall local brew:

rm -rf ~/.local/opt/brew
webi brew

If you need to uninstall global brew:

For Mojave, Catalina, Big Sur, and above:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall.sh)"

For High Sierra and below:

/bin/bash -c ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"