Skip to content

Installing Homebrew on macOS, Step by Step

A practical walk-through of getting Homebrew running on macOS, including the permissions, network conditions, and local paths that shape a real install in your own country.

What is Homebrew, and what does installing it actually do

Before touching a terminal, it helps to answer the plain question: what is Homebrew? It is a package manager for macOS that lets you fetch, install, and remove command-line tools and applications without hunting for installers on individual websites. When people ask for a homebrew overview, the short version is that it downloads a small script, sets up a directory structure on your disk, and connects that structure to online repositories holding thousands of ready-to-install packages.

Installing Homebrew on macos is mostly a matter of running one official install command in Terminal, then letting it create folders, adjust your shell configuration, and check that supporting command-line tools are present. Nothing about this process is region-specific in principle, but in practice your network provider, your local DNS behaviour, and any interception by a workplace or campus firewall can all change how smoothly the download completes. Read this section as the homebrew basics you need before you type anything.

Regional prerequisites: what your local setup needs first

Every macOS install of Homebrew depends on Apple's command-line developer tools being present, since Homebrew uses the compiler and related utilities they provide. On a fresh Mac bought locally, these tools are usually not installed yet, and the Homebrew installer will prompt you to install them the first time you run it. This step needs a working internet connection, and in areas with slower or metered connections it can be the longest part of the whole process, often longer than downloading Homebrew itself.

Depending on where you are, your internet service provider's routing to Apple's and the open-source project's servers can vary noticeably in speed. If a download stalls or times out partway through, it is frequently a local routing or firewall issue rather than a problem with Homebrew or your Mac. Retrying on a different network, such as switching from a shared office connection to a home connection or a mobile hotspot, resolves most of these regional slowdowns without needing any special configuration.

Permissions: why Homebrew asks for administrator access

During installation, macOS will ask for your account password at least once. This is because Homebrew needs to create and take ownership of a directory that will hold everything it manages, and only an administrator account can grant that. This is a normal part of how homebrew works on macOS and is not unique to any country or network setup, though local IT policies on managed work laptops can sometimes block this step entirely.

If you use a Mac issued by an employer or an educational institution, check whether your account has administrator rights before starting. Many organisations restrict this deliberately, and in that case installing Homebrew may require raising a request with local IT support rather than troubleshooting the installer itself. This is one of the more common points of confusion for people encountering homebrew for beginners material that assumes an unrestricted personal machine.

Local paths: where Homebrew actually lives on your disk

Homebrew installs to one of two standard locations depending on your Mac's processor. On Apple silicon Macs, it lives under a dedicated top-level folder; on older Intel-based Macs, it installs into a folder already used by other Unix tools. Knowing this local path matters because it explains why some commands work only after you open a new terminal window, and why software installed through Homebrew sits separately from applications you download directly.

After installation, the setup process usually asks you to add a line to your shell configuration file so that your terminal knows where to find Homebrew's programs. This step is easy to skip by accident, and skipping it is the single most common reason a fresh Homebrew install seems to disappear immediately after finishing. If commands are not recognised right after installing, checking this configuration line first will solve the issue in almost every case.

Mirrors and network behaviour during setup

Homebrew reaches out to remote repositories to download both its own core files and the packages you request. Depending on your country, some networks route these requests efficiently while others experience noticeable slowdowns, particularly during peak evening hours when many households and offices share limited upstream bandwidth. None of this affects correctness, only speed, and Homebrew is built to resume or retry a download that gets interrupted partway through.

If installs feel unusually slow in your area, it is worth checking whether a local firewall, antivirus product, or content filter is inspecting encrypted traffic, since this can add delay without producing any obvious error message. This is a subtle but real factor in how homebrew works in practice for readers on restrictive corporate or educational networks, and it is often mistaken for a fault in Homebrew itself.

Install Method Comparison

Choosing How to Install Homebrew Locally

MethodBest forTrade-off
Official install script via TerminalMost personal Macs with standard internet accessRequires comfort typing one command; needs admin password
Manual download and extractionMachines with restricted script execution policiesMore manual steps; you manage the local path yourself
Installing behind a corporate proxyWork laptops on managed networksOften needs IT-provided proxy settings before the script will run
Reinstalling after a macOS upgradeUsers who moved to a new Mac or did a clean OS installStraightforward but re-downloads everything from scratch
Common Questions

Questions Readers Ask Before Installing

What is Homebrew, in one sentence?

Homebrew is a package manager for macOS that automates downloading, installing, updating, and removing command-line tools and applications from organised online repositories, rather than requiring manual installers for each one.

Do I need a fast internet connection to install it?

A stable connection matters more than raw speed. The install itself is small, but the accompanying developer tools download can be sizeable, so an interrupted or heavily filtered local connection is the most common cause of a stalled setup.

Why does installing Homebrew ask for my password?

It needs administrator permission once, to create and take ownership of the main folder it will use going forward. This is a one-time step during setup, not something repeated for every later package install.

Does my country affect how Homebrew installs?

The install process itself is identical everywhere, but local network routing, provider speeds, and any workplace or institutional filtering can change how quickly and reliably the download completes.

What if the terminal says 'command not found' after installing?

This almost always means your shell configuration was not updated with Homebrew's local path. Reopening the terminal or adding the suggested configuration line during setup resolves it in nearly every case.

Can I install Homebrew without administrator rights?

Generally no, since it needs to create a system-level folder it owns. On managed devices without admin access, this typically requires assistance from local IT support rather than a workaround on your end.

Is installing Homebrew different on Apple silicon versus Intel Macs?

The install steps are the same, but the resulting local path differs, which matters mainly if you are troubleshooting missing commands or reading documentation that assumes one processor type.