brew(1) – The missing package manager for macOS

SYNOPSIS

brew --version
brew command [--verbose|-v] [options] [formula] …

DESCRIPTION

Homebrew is the easiest and most flexible way to install the UNIX tools Apple didn’t include with macOS.

ESSENTIAL COMMANDS

For the full command list, see the COMMANDS section.

With --verbose or -v, many commands print extra debugging information. Note that these flags should only appear after a command.

COMMANDS

DEVELOPER COMMANDS

OFFICIAL EXTERNAL COMMANDS

Homebrew/homebrew-bundle https://github.com/Homebrew/homebrew-bundle

Homebrew/homebrew-cask https://github.com/Homebrew/homebrew-cask

Homebrew/homebrew-services https://github.com/Homebrew/homebrew-services

CUSTOM EXTERNAL COMMANDS

Homebrew, like git(1), supports external commands. These are executable scripts that reside somewhere in the PATH, named brew-cmdname or brew-cmdname.rb, which can be invoked like brew cmdname. This allows you to create your own commands without modifying Homebrew’s internals.

Instructions for creating your own commands can be found in the docs: https://docs.brew.sh/External-Commands

SPECIFYING FORMULAE

Many Homebrew commands accept one or more formula arguments. These arguments can take several different forms:

ENVIRONMENT

Note that environment variables must have a value set to be detected. For example, export HOMEBREW_NO_INSECURE_REDIRECT=1 rather than just export HOMEBREW_NO_INSECURE_REDIRECT.

USING HOMEBREW BEHIND A PROXY

Use the http_proxy, https_proxy, all_proxy, no_proxy and/or ftp_proxy documented above.

For example for an unauthenticated HTTP or SOCKS5 proxy:

export http_proxy=http://`host`:`port`

export all_proxy=socks5://`host`:`port`

And for an authenticated HTTP proxy:

export http_proxy=http://`user`:`password`@`host`:`port`

SEE ALSO

Homebrew Documentation: https://docs.brew.sh

brew-cask(1), git(1), git-log(1)

AUTHORS

Homebrew’s lead maintainer is Mike McQuaid.

Homebrew/homebrew-core’s lead maintainer is ilovezfs.

Homebrew/brew’s other current maintainers are ilovezfs, JCount, Misty De Meo, Gautham Goli, Markus Reiter and William Woodruff.

Homebrew/homebrew-core’s other current maintainers are FX Coudert, JCount, Misty De Meo and Tom Schoonjans.

Former maintainers with significant contributions include Tim Smith, Baptiste Fontaine, Xu Cheng, Martin Afanasjew, Dominyk Tiller, Brett Koonce, Charlie Sharpsteen, Jack Nagel, Adam Vandenberg, Andrew Janke, Alex Dunn, neutric, Tomasz Pajor, Uladzislau Shablinski, Alyssa Ross, and Homebrew’s creator: Max Howell.

BUGS

See our issues on GitHub:

Fork me on GitHub