How to Install Homebrew on Mac (Step-by-Step Guide)

by
PinLinkedIn

If you use a Mac and want access to powerful developer tools, open-source software, and command-line utilities, Homebrew is one of the best additions you can make to your system. Often described as “the missing package manager for macOS,” Homebrew allows you to install, update, and manage software directly from the Terminal—quickly and efficiently.

TLDR: Homebrew is a free macOS package manager that makes installing software simple using the Terminal. To install it, you just need to run a single command provided on the official Homebrew website. After installation, you can use commands like brew install, brew update, and brew upgrade to manage software. The setup takes only a few minutes and opens up a powerful ecosystem of developer tools and applications.

What Is Homebrew and Why Should You Install It?

Homebrew is a package manager for macOS (and Linux). In simple terms, it’s a tool that helps you download, install, and manage applications from the command line. Instead of manually downloading files from websites and dragging apps into your Applications folder, you can install tools with a single command.

For example:

  • Install Git: brew install git
  • Install Node.js: brew install node
  • Install Python: brew install python

Homebrew handles dependencies automatically, ensures compatibility with your macOS version, and makes updating software incredibly simple.

Before You Install Homebrew

Before you begin, make sure your Mac meets the following requirements:

  • macOS 10.14 (Mojave) or newer
  • Administrator access to install software
  • Internet connection

You’ll also need Apple’s Command Line Tools. Don’t worry—if they’re not installed, the Homebrew installer will prompt you automatically.

Step 1: Open Terminal

Homebrew is installed via the Terminal app.

To open Terminal:

  1. Press Command + Space to open Spotlight Search
  2. Type Terminal
  3. Press Enter

Alternatively, you can find it under:

Applications → Utilities → Terminal

Step 2: Copy the Official Homebrew Installation Command

Visit the official Homebrew website:

https://brew.sh

You’ll see a command that looks similar to this:

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

Important: Always copy the installation command directly from the official website to ensure you’re using the latest and safest version.

Step 3: Run the Installation Command

Paste the copied command into Terminal and press Enter.

What happens next:

  • The installer checks your system
  • It may prompt you for your Mac password
  • It installs required dependencies
  • It downloads and configures Homebrew

During installation, you might see messages about:

  • Installing Command Line Tools
  • Configuring directories
  • Setting up environment variables

This process usually takes 5–15 minutes, depending on your internet speed.

Step 4: Add Homebrew to Your PATH (If Required)

After installation, you may see additional instructions in the Terminal window. For example:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

This step ensures your Mac knows where to find the brew command.

Simply copy and paste the provided commands into Terminal if prompted.

If you’re using:

  • Apple Silicon (M1, M2, M3) → Installed in /opt/homebrew
  • Intel Mac → Installed in /usr/local

Step 5: Verify the Installation

To confirm Homebrew is installed correctly, type:

brew --version

If installed successfully, you’ll see output like:

Homebrew 4.x.x

You can also run:

brew doctor

This command checks your system for potential issues and provides recommendations.

How to Use Homebrew

Now that Homebrew is installed, here are the most useful commands you should know:

1. Install Software

brew install package-name

Example:

brew install wget

2. Update Homebrew

brew update

This updates Homebrew itself and its package list.

3. Upgrade Installed Packages

brew upgrade

Updates all installed software to the latest version.

4. Search for Packages

brew search package-name

5. Remove Software

brew uninstall package-name

Formulae vs Casks: What’s the Difference?

Homebrew installs two main types of software:

  • Formulae – Command-line tools (e.g., git, node, python)
  • Casks – GUI applications (e.g., Chrome, VS Code, Docker)

To install a graphical application, use:

brew install --cask google-chrome

Popular Tools You Can Install with Homebrew

Here’s a comparison of commonly installed tools:

Tool Type Main Purpose Install Command
Git Formula Version control brew install git
Node.js Formula JavaScript runtime brew install node
Python Formula Programming language brew install python
Visual Studio Code Cask Code editor brew install –cask visual-studio-code
Google Chrome Cask Web browser brew install –cask google-chrome

Common Installation Problems (And Fixes)

1. “Command Not Found: brew”

This usually means Homebrew is not added to your PATH. Run the shell configuration commands suggested at the end of installation.

2. Permission Errors

Make sure you’re using an administrator account. Avoid manually changing directory permissions unless specifically instructed.

3. Xcode Command Line Tools Missing

Install them manually with:

xcode-select --install

How to Keep Homebrew Updated

To ensure system stability and security, regularly run:

brew update
brew upgrade
brew cleanup
  • brew update refreshes available packages
  • brew upgrade updates installed tools
  • brew cleanup removes outdated files

Running these once every couple of weeks is usually sufficient.

How to Uninstall Homebrew (If Needed)

If you ever decide to remove Homebrew, run the official uninstall script from the Homebrew repository. Always copy the latest command from the official documentation to ensure safe removal.

The uninstallation process removes:

  • Installed formulae and casks
  • Homebrew directories
  • Configuration files

Why Homebrew Is Worth It

Installing Homebrew transforms your Mac into a more powerful development environment. Instead of manually hunting down installers, managing versions, and tracking updates, you centralize everything in one simple command-line tool.

Benefits include:

  • Time savings
  • Automatic dependency handling
  • Easy updates
  • Access to thousands of packages

Even if you’re not a professional developer, Homebrew is incredibly useful for installing utilities, browsers, productivity apps, and programming languages quickly and safely.

Final Thoughts

Installing Homebrew on macOS is one of the smartest setup steps you can take. The process is straightforward: open Terminal, paste one command, follow simple prompts, and verify your installation. Within minutes, you gain access to a vast ecosystem of software—all manageable through clean, simple commands.

Whether you’re coding, automating tasks, or just want better control over your Mac’s software environment, Homebrew makes it fast, clean, and efficient. Once you start using it, you’ll likely wonder how you ever managed your Mac without it.

PinLinkedIn