Free Guide to Installing Homebrew on Mac and Linux

What Homebrew Is and Why Developers Use It

Homebrew is a package manager—essentially a tool that handles the installation and upkeep of software on your computer. Think of it like an app store for the command line. Instead of hunting through websites, downloading installers, and managing updates manually, Homebrew lets you type one command to fetch, install, and maintain tools that developers rely on every day.

Learn How to Make Ceviche at Home →

On macOS and Linux, many important development tools don't come pre-installed. Things like Git (version control software), Node.js (for JavaScript development), Python, Ruby, PostgreSQL, and hundreds of other programs need to be installed separately. Before Homebrew existed, developers spent significant time wrestling with installation instructions, dependency issues, and version conflicts. Homebrew solved this problem by creating a standardized way to manage these tools.

The system works through "formulae"—recipes that tell Homebrew exactly how to build and install each piece of software. When you install something through Homebrew, it handles downloading the right version, checking for dependencies, and putting files in the correct locations. If a newer version comes out, you can update everything with a single command. Homebrew currently maintains over 13,000 formulae across its main repository, covering everything from development frameworks to media tools to productivity software.

Homebrew is particularly valuable for people learning to code or working on multiple projects. Rather than spending hours troubleshooting installations, you can focus on actual learning and development. Many coding bootcamps and computer science programs recommend Homebrew as a first tool to install when setting up a development environment. The difference between manually installing five tools (potentially spending hours on version mismatches) and using Homebrew to install the same tools in minutes is substantial.

Key takeaway: Homebrew transforms what could be a frustrating technical setup process into something straightforward, which means more time for actual coding work.

System Requirements and Pre-Installation Checks

Before installing Homebrew, your computer needs to meet some basic requirements. On macOS, you need at least macOS 11 (Big Sur) or newer. If you're running an older version, you'll want to update your operating system first. For Linux, Homebrew works on most major distributions including Ubuntu, Debian, Fedora, CentOS, and others—though the installation process has some variations depending on which distribution you use.

Learn About Managing Electrolyte Imbalance at Home →

Both macOS and Linux installations require a few foundational tools already in place. On macOS, you need Xcode Command Line Tools, which is Apple's suite of development tools. On Linux, you'll need a C compiler (usually gcc or clang), make, and some standard development libraries. Don't worry if you don't have these yet—the Homebrew installation process will guide you through getting them.

Here's what you should check before beginning:

• Verify your operating system version (on Mac, click the Apple menu, select "About This Mac"; on Linux, run lsb_release -a or check your system settings)
• Confirm you have administrator access on your computer—you'll need this to install system tools
• Make sure you have an internet connection, as Homebrew needs to download software
• Ensure you have at least 500 MB of free disk space for Homebrew itself, plus additional space for the programs you'll install
• If you're on macOS, check whether Xcode Command Line Tools is already installed by opening Terminal and typing xcode-select --version

If you're new to using Terminal or command line, that's fine—Homebrew is designed to work with straightforward commands. The installation involves typing commands and pressing Enter, which you can do by copying and pasting directly from official sources. One thing to be cautious about: only copy installation commands from the official Homebrew website (brew.sh) or other trusted sources. Never paste commands from random websites without understanding what they do.

Key takeaway: Spending five minutes checking these requirements upfront prevents installation problems later and ensures Homebrew runs smoothly on your system.

Installing Homebrew on macOS Step by Step

The macOS installation process typically takes 5 to 15 minutes depending on your internet speed and whether you already have Xcode Command Line Tools installed. The first step is opening Terminal, which is located in Applications > Utilities. You can also search for "Terminal" using Spotlight (Command + Spacebar).

Learn How to Make Chicken Dumplings at Home →

Once Terminal is open, you'll paste the official Homebrew installation command, which as of recent versions looks like this: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)". This command downloads Homebrew's installation script and runs it. When you press Enter, Terminal may ask for your password—this is normal. You need administrator privileges to install system software.

During installation, several things happen automatically:

• If you don't have Xcode Command Line Tools, macOS will prompt you to install them. If this happens, click "Install" and wait for the download and installation to complete (this can take 10-15 minutes on slower connections)
• Homebrew creates a directory at /usr/local/Homebrew where it stores itself and the software it manages
• The installer modifies your shell configuration file so that Terminal knows where to find Homebrew commands
• Once complete, Terminal displays a success message and instructions for next steps

After installation finishes, you should close and reopen Terminal. Then verify the installation worked by typing brew --version. This command should display the version number of Homebrew, confirming it's installed and accessible. You might also run brew doctor, which checks for any configuration issues. If everything looks good, you're ready to start installing packages.

If installation fails, the error message usually indicates the specific problem. Common issues include insufficient disk space, network timeouts during the Xcode download, or permission problems. If you encounter an error, read the message carefully—it often tells you exactly what went wrong and how to fix it. The Homebrew community is active, and searching the specific error message usually yields solutions.

Key takeaway: The macOS installation is straightforward when done from the official source, and verification with two simple commands confirms everything is working.

Installing Homebrew on Linux—Distribution-Specific Approaches

Linux installation is slightly more involved than macOS because it varies by distribution, but the overall process is still manageable. The most common approach uses the official Homebrew installation script, but some Linux distributions have additional requirements or alternative methods.

Get Your Free Enterprise Car Rental Promo Code Guide →

For Ubuntu and Debian-based systems (including Linux Mint, Pop!_OS, and others), you'll first want to make sure you have the required development tools. Open Terminal and run this command: sudo apt-get update && sudo apt-get install -y build-essential curl file git. This installs the C compiler, build tools, and other necessities. The sudo prefix means you're running the command with administrator privileges, and -y automatically answers "yes" to prompts.

After those prerequisites are installed, run the main Homebrew installation command: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)". When prompted, paste your password and let the script complete.

For Fedora, CentOS, or RHEL-based systems, the prerequisite command differs slightly: sudo dnf install -y gcc g++ make curl file git. Then use the same main installation command as above.

Here's what differs across distributions:

• Ubuntu/Debian: Uses apt-get or apt for package management; install build-essential
• Fedora/CentOS: Uses dnf or yum for package management; install development tools group
• Arch Linux: Some users prefer native package managers, but Homebrew is available
• Alpine Linux: Not officially supported by Homebrew