The Homebrew package manager may be used on Linux and Windows 10, using Windows Subsystem for Linux (WSL). Homebrew is referred to as Linuxbrew when running on Linux or Windows. It can be installed in your home directory, in which case it does not use sudo. Linuxbrew does not use any libraries provided by your host system, except glibc and gcc if they are new enough. Linuxbrew can install its own current versions of glibc and gcc for older distribution of Linux.
Features, dependencies and installation instructions are described below. Terminology (e.g. the difference between a Cellar, Tap, Cask and so forth) is explained in the documentation.
- Can install software to your home directory and so does not require sudo
- Install software not packaged by your host distribution
- Install up-to-date versions of software when your host distribution is old
- Use the same package manager to manage your macOS, Linux, and Windows systems
Paste at a terminal prompt:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Linuxbrew/install/master/install.sh)"
The installation script installs Linuxbrew to
/home/linuxbrew/.linuxbrew using sudo if possible and in your home directory at
~/.linuxbrew otherwise. Linuxbrew does not use sudo after installation. Using
/home/linuxbrew/.linuxbrew allows the use of more binary packages (bottles) than installing in your personal home directory.
Follow the Next steps instructions to add Linuxbrew to your
PATH and to your bash shell profile script, either
~/.profile on Debian/Ubuntu or
~/.bash_profile on CentOS/Fedora/RedHat.
test -d ~/.linuxbrew && eval $(~/.linuxbrew/bin/brew shellenv) test -d /home/linuxbrew/.linuxbrew && eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv) test -r ~/.bash_profile && echo "eval \$($(brew --prefix)/bin/brew shellenv)" >>~/.bash_profile echo "eval \$($(brew --prefix)/bin/brew shellenv)" >>~/.profile
You’re done! Try installing a package:
brew install hello
If you’re using an older distribution of Linux, installing your first package will also install a recent version of
brew doctor to troubleshoot common issues.
- GCC 4.4 or newer
- Linux 2.6.32 or newer
- Glibc 2.12 or newer
- 64-bit x86 CPU
Paste at a terminal prompt:
Debian or Ubuntu
sudo apt-get install build-essential curl file git
Fedora, CentOS, or Red Hat
sudo yum groupinstall 'Development Tools' && sudo yum install curl file git
Linuxbrew can run on Raspberry Pi (32-bit ARM), but no binary packages (bottles) are available. Support for Raspberry Pi is on a best-effort basis. Pull requests are welcome to improve the experience on Raspberry Pi.
Linuxbrew does not currently support 32-bit x86 platforms. It would be possible for Linuxbrew to work on 32-bit x86 platforms with some effort. An interested and dedicated person could maintain a fork of Homebrew to develop support for 32-bit x86.
git clone Linuxbrew wherever you want. Use
/home/linuxbrew/.linuxbrew if possible.
git clone https://github.com/Homebrew/brew ~/.linuxbrew/Homebrew mkdir ~/.linuxbrew/bin ln -s ../Homebrew/bin/brew ~/.linuxbrew/bin eval $(~/.linuxbrew/bin/brew shellenv)
What Packages Are Available?
brew searchfor a list.
- Or visit formulae.brew.sh to browse packages online.
- Or use
brew search --desc <keyword>to browse packages from the command line.
man brew or check our documentation.
First, please run
brew update and
Second, read the Troubleshooting Checklist.
If you don’t read these it will take us far longer to help you with your problem.
We’d love you to contribute to Linuxbrew. First, please read our Contribution Guide and Code of Conduct. Please see our guidelines on whether to send pull requests to Linuxbrew or Homebrew.
We explicitly welcome contributions from people who have never contributed to open-source before: we were all beginners once! We can help build on a partially working pull request with the aim of getting it merged. We are also actively seeking to diversify our contributors and especially welcome contributions from women from all backgrounds and people of colour.
A good starting point for contributing is running
brew audit --strict with some of the packages you use (e.g.
brew audit --strict wget if you use
wget) and then read through the warnings, try to fix them until
brew audit --strict shows no results and submit a pull request. If no formulae you use have warnings you can run
brew audit --strict without arguments to have it run on all packages and pick one.
Alternatively, for something more substantial, check out one of the issues labeled
help wanted in Homebrew/brew or Homebrew/homebrew-core.
Please report security issues to our HackerOne.
Who Are You (Linuxbrew)?
Linuxbrew’s lead maintainer is Shaun Jackman.
Linuxbrew/homebrew-core’s lead maintainer is Michka Popoff.
Linuxbrew’s other current maintainers are Piotr Gaczkowski, Maxim Belkin, Jonathan Chang, and Alyssa Ross.
Former Linuxbrew maintainers with significant contributions include Bob W. Hogg.
Who Are You (Homebrew)?
Homebrew’s lead maintainer is Mike McQuaid.
Homebrew’s project leadership committee is Mike McQuaid, Misty De Meo and Markus Reiter.
Homebrew/brew’s other current maintainers are Claudia, Michka Popoff, Shaun Jackman, Chongyu Zhu, Vitor Galvao, Misty De Meo, Gautham Goli, Markus Reiter, Steven Peters, Jonathan Chang and William Woodruff.
Homebrew/brew’s Linux support (and Linuxbrew) maintainers are Michka Popoff and Shaun Jackman.
Homebrew/homebrew-core’s other current maintainers are Claudia, Michka Popoff, Shaun Jackman, Chongyu Zhu, Izaak Beekman, Sean Molenaar, Jan Viljanen, Jason Tedor, Viktor Szakats, FX Coudert, Thierry Moisan, Steven Peters, Misty De Meo and Tom Schoonjans.
Former maintainers with significant contributions include JCount, commitay, Dominyk Tiller, Tim Smith, Baptiste Fontaine, Xu Cheng, Martin Afanasjew, Brett Koonce, Charlie Sharpsteen, Jack Nagel, Adam Vandenberg, Andrew Janke, Alex Dunn, neutric, Tomasz Pajor, Uladzislau Shablinski, Alyssa Ross, ilovezfs and Homebrew’s creator: Max Howell.
Code is under the BSD 2-clause “Simplified” License. Documentation is under the Creative Commons Attribution license.
Linuxbrew is a non-profit project run entirely by unpaid volunteers. We need your funds to pay for continuous integration and the computer resources used to build precompiled binary bottles of your favourite formulae. Every donation will be spent on making Linuxbrew better for our users.
Please consider donating regularly to Linuxbrew through Patreon. We appreciate your support and contribution, no matter the level.
Linuxbrew is a fork of Homebrew, the macOS package manager, for Linux. Please consider donating to Homebrew as well if you use Homebrew on macOS.
Our binary packages (bottles) are built on CircleCI and hosted by Bintray.