How to Install Homebrew on Mac

tutorial
How to Install Homebrew on Mac

Installing Homebrew gives you the fastest way to install developer tools, open-source apps, and command-line utilities on macOS. Instead of hunting for installers, you manage everything from the Terminal with simple commands.

Most installation issues come from missing prerequisites or incorrect PATH setup. Follow the steps below in order to avoid those problems.

What Homebrew is and why Mac users need it

Homebrew acts as a package manager for macOS. It installs, updates, and removes software with a single command, saving time and reducing setup errors.

Developers, power users, and even beginners rely on Homebrew to manage tools like Git, Node.js, Python, and hundreds of other utilities.

What you need before installing Homebrew

Before you run the installer, confirm your Mac meets the basic requirements. This prevents install failures halfway through the process.

You need a supported macOS version, an internet connection, and administrator access on your Mac.

Check your Mac processor

Apple Silicon and Intel Macs use different default install paths. Knowing your processor avoids PATH issues later.

  1. Click the Apple menu.
  2. Select About This Mac.
  3. Check whether your Mac lists an Apple chip or an Intel processor.

Make sure Xcode Command Line Tools are installed

Homebrew depends on Apple’s developer tools to compile and manage packages. macOS often installs them automatically during setup, but not always.

  • Open Terminal.
  • Run: xcode-select --install
  • Follow the on-screen prompt if macOS asks to install the tools.

How to install Homebrew on Mac

Homebrew provides an official install script that handles setup safely. Always use this method to stay compatible with future macOS updates.

Run the Homebrew install command in Terminal

This command downloads and configures Homebrew automatically.

  1. Open Terminal.
  2. Paste and run: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. Press Return to start the process.

Enter your Mac password and wait for setup

The installer asks for your password to create the required directories. The Terminal does not show characters while typing, which is normal.

Wait until the script finishes and displays a completion message.

Set up Homebrew PATH correctly

Homebrew may install correctly, but fail to run if your shell cannot find it. You need to set the PATH variable on macOS correctly to fix this problem.

Add Homebrew to PATH on Apple Silicon Macs

Apple Silicon Macs install Homebrew in /opt/homebrew by default: echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Add Homebrew to PATH on Intel Macs

Intel Macs usually install Homebrew in /usr/local, which already exists in PATH.

If Terminal cannot find brew, run: echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zprofile

Restart Terminal after making changes.

Verify that Homebrew installed correctly

Verification confirms that Homebrew works before you install software.

Check the Homebrew version

This command should return a version number without errors: brew --version

Run a quick diagnostic check

Homebrew includes a built-in health check: brew doctor

Read the output carefully and fix any issues it reports.

Install your first package with Homebrew

Installing a package confirms the full setup works end to end.

Example: install a common tool

Try installing Git as a test: brew install git

If the install completes without errors, Homebrew works correctly.

Common Homebrew install errors and quick fixes

“brew command not found”

This error almost always means PATH is misconfigured. Recheck the PATH steps for your Mac type and restart Terminal.

Permission or ownership errors

Avoid using sudo with brew commands. Homebrew expects you to own its directories, not root.

Running brew doctor usually points to the exact fix.

Xcode tools not found or outdated

Reinstall the tools with: xcode-select --install

Then rerun the Homebrew install if needed.

Tips

  • Update Homebrew regularly with brew update to stay compatible with macOS updates.
  • Use brew upgrade to keep installed packages current.
  • Run brew cleanup occasionally to remove unused files.
  • Avoid copying random install commands from old blog posts.

FAQs

Can I install Homebrew without Xcode? No. Homebrew requires Xcode Command Line Tools to compile and manage packages correctly.

Does Homebrew slow down my Mac? Homebrew only runs when you use it. Installed packages do not affect system performance.

Is Homebrew safe to use? Yes. Homebrew uses open-source formulas and installs software in isolated directories.

Can I remove Homebrew later? Yes. Homebrew provides an official uninstall script for complete removal.

Summary

  1. Check your Mac processor and install Xcode Command Line Tools.
  2. Run the official Homebrew install command in Terminal.
  3. Fix PATH based on Apple Silicon or Intel.
  4. Verify the installation and test with a sample package.

Homebrew installation usually takes less than ten minutes when prerequisites are in place. Once installed, you can manage most Mac tools from a single, reliable command line workflow.

Discover: Productivity

Discussion (0)

Be the first to comment.