How to Install Brew on Mac: A Step-by-Step Guide

Why brew on mac

According to Install Manual, Homebrew simplifies installing open-source software on

What is Homebrew

Homebrew is a free, community-driven package manager for

Prerequisites and system readiness

Before you install Brew, confirm your Mac meets the basic prerequisites. You should have an active internet connection, administrative access to the device, and enough disk space to accommodate the Homebrew cache and installed packages.

Install Command Line Tools (CLT) for

Install Brew on Intel Macs

The process for Intel Macs is straightforward. Start Terminal and prepare the install environment. The official Brew installer will set up the Homebrew directory, typically under /usr/local, and will prompt you to add its bin directory to your PATH if it’s not already present. You’ll be guided through a license agreement and a series of prompts during the download and installation. After the script completes, restart your Terminal or source your shell profile so the new PATH is recognized. Finally, run brew --version to confirm the installation and test a simple package like wget to validate the setup. This path is the most common starting point for older Macs still serving development needs.

Install Brew on Apple Silicon Macs (M1/M2)

Apple Silicon Macs place Homebrew in a different default location, /opt/homebrew, to optimize performance and security. The installer detects the architecture and guides you through the process. After installation, you’ll want to ensure /opt/homebrew/bin is on your PATH for all shells. If you used zsh, add a line to your ~/.zshrc; if you use bash, add it to ~/.bash_profile or ~/.bashrc. The verification steps are the same: run brew --version, brew doctor, then try installing a test package. With Apple Silicon, this separation helps maintain compatibility with older x86_64 bottles while enabling native ARM64 binaries for current software.

Verifying the install and basic usage

Verification starts with confirming Brew’s version, health, and basic environment. Run brew --version to verify the binary is accessible, and brew doctor to let Brew check for common misconfigurations. Update Brew with brew update, and consider upgrading an installed package with brew upgrade. For a practical test, install a widely used utility such as wget or htop to confirm the toolchain and dependencies resolve correctly. This section also covers common post-install tweaks, like configuring mirrors, adjusting the download cache, and ensuring your PATH remains intact after terminal sessions or shell changes. As you gain experience, you’ll rely on Brew to catalyze reproducible setups across devices, which Install Manual highlights as a best practice for home projects and professional tasks.

Maintenance, updates, and common issues

Keeping Brew healthy requires periodic maintenance. Run brew update to fetch the latest package definitions, brew upgrade to apply updates to installed formulae, and brew cleanup to reclaim disk space by removing old versions. Be mindful of conflicts with system-provided utilities or pre-installed apps; Brew aims to coexist by isolating its own directory and using symlinks. If a formula fails to install, check dependencies, verify your CLT installation, and consider running brew doctor for diagnostics. In most cases, issues resolve quickly after a clean update and a retry. Maintaining a tidy Brew environment also includes removing unused formulae with brew uninstall and auditing taps to ensure you’re pulling from trusted sources.