FastBrew

Homebrew guide for Mac

How to install Homebrew on macOS, how formulas differ from casks, and the commands you will use most.

What is Homebrew?

Homebrew is a package manager for macOS. You use it in the terminal to install command-line tools and desktop apps.

Why use Homebrew?

Homebrew installs, updates, and removes software that the Mac App Store does not carry. It also installs the packages each one depends on.

Benefits

  • One command installs or updates a package
  • Dependencies install with the package
  • Thousands of formulas and casks

Who uses it

  • Developers
  • System administrators
  • People who set up Macs often
Installation guide

Run one command, then finish setup in three steps

System requirements

A recent macOS version on Apple Silicon or Intel, and the Xcode Command Line Tools. The installer offers to add them. Homebrew lists the supported versions in its installation docs.

Install command

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

The script lists what it will install and waits for you to press Return.

Post-installation setup

  1. 1. Add Homebrew to PATH using the commands from the installer.
  2. 2. Check the installation by running brew doctor.
  3. 3. Update Homebrew by running brew update.
Formulas and casks

Homebrew has two kinds of packages

Aspect Formulas Casks
What they install Command-line tools and libraries GUI applications
Installation location /opt/homebrew/Cellar, or /usr/local/Cellar on Intel /Applications folder
Install command brew install [name] brew install --cask [name]
Examples git, node, python, wget Chrome, Slack, VS Code, Spotify
Use case Development tools and servers Desktop and productivity apps
Essential commands

The commands you will use most

CommandDescription
brew install [package] Install a formula or cask
brew uninstall [package] Remove a package
brew list List all installed packages
brew search [text] Search for packages
brew info [package] Display package details
Good habits

Do

  • Run brew update before installing
  • Use brew doctor when something breaks
  • Run brew upgrade to update installed packages
  • Clean old versions with brew cleanup
  • Use casks for GUI applications

Avoid

  • Using sudo with brew commands
  • Deleting formula files by hand
  • Ignoring brew doctor warnings
  • Installing the same tool with Homebrew and another package manager
  • Installing duplicates without checking brew list
Find apps to install

Search the FastBrew catalog and build one install command for your Mac.