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 glibc
and gcc
. Use 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:
sudo apt-get install build-essential curl file git
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.
Extract or 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)
- Type
brew search
for a list. - Or visit formulae.brew.sh to browse packages online.
- Or use
brew search --desc <keyword>
to browse packages from the command line.
brew help
, man brew
or check our documentation.
First, please run brew update
and brew doctor
.
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.
Good luck!
Please report security issues to our HackerOne.
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.
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 Pellegrino, 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 Pellegrino, Igor Kapkov, 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.