Setting Up Homebrew

Any command-line user will know that a robust package manager is not only essential, but something that is a great advantage over your typical GUI. All of the major Linux distributions have package mangers built in: Arch Linux has pacman, Debian-based distributions have APT, Fedora has rpm, and Gentoo has Portage. But out of the box, there is no package manager for macOS.

Homebrew is a community-created package manager for macOS that functions just like any other package manager for Linux. Applications are simple to install, with simple commands to do so. Dependencies are handled automatically by Homebrew, meaning one only needs to tell it to install the application they want, and all of its requirements will be installed as well. All applications can be updated with a single command. And since this all runs through the terminal, it can be scripted and runs fast compared to updates through the Mac App Store.

Installing Homebrew



Copy and paste the following code into an iTerm or session:

/usr/bin/ruby -e "$(curl -fsSL"

By default, Homebrew uses Google Analytics to determine how it is being used. This is used to determine what features are a priority and which applications to include in the package manager. For privacy reasons, analytics can be turned off with the following command.

brew analytics off

Once Homebrew is installed, the next step is to make sure that it is fully updated with all of the latest applications. To do this, run the following command.

brew update

With that, Homebrew is installed and fully up-to-date, ready to be used.

Basic Commands


Installing an application through Homebrew is as simple as typing the following command, replacing with the name of what you want to install:

brew install <application>


To update Home and all applications within Homebrew, type the following command:

brew update

This will update the list of installable applications, as well as showing you which of your installed applications have upgrades available.


To upgrade every application managed by Homebrew, run the following command:

brew upgrade

To upgrade a single application, type its name after the above command:

brew upgrade <application>


To see a list of everything currently installed by Homebrew, enter this command:

brew list


Since Homebrew manages dependencies automatically, installing one application can end up installing multiple things at once. To view more detailed information about a particular application, enter the following command:

brew info <application>

This will provide information about what the application is. It will also include a list of required dependencies for that application, with a notation as to whether it is or is not already installed.

pin and unpin

To prevent an application from being updated, type the following command:

brew pin <application>

Once you are ready to allow an application to be updated again, enter the command:

brew unpin <application>


When applications are upgraded, the previous versions are not removed from the computer. To remove all old versions of applications, enter the command:

brew cleanup

If you would like to see everything that would be removed along with a total amount of disk space used by these old versions, enter the command:

brew cleanup -n

In about 4 months of my own heavy Homebrew usage, this meant freeing up around 500 megabytes of storage.


If Homebrew acts up, or a new version of Xcode has been installed, Homebrew has its own internal diagnostics command that will find errors within itself and correct them. To do this, enter the following command:

brew doctor

If Homebrew is unable to fix itself, this command will also output what is wrong and guide you in how to fix the problem.