Homebrew

The Missing Package Manager for macOS (or Linux)

  • Install Homebrew

    Image for: Install Homebrew

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"


    Paste that in a macOS Terminal or Linux shell prompt.

    The script explains what it will do and then pauses before it does it. Read about other installation options.

    If you're on macOS, try our new .pkg installer.

    Download it from Homebrew's latest GitHub release.

  • What Does Homebrew Do?

    Image for: What Does Homebrew Do?

    Homebrew installs the stuff you need that Apple (or your Linux system) didn’t.

    $ brew install wget
  • Homebrew installs packages to their own directory and then symlinks their files into /opt/homebrew (on Apple Silicon).

    $ cd /opt/homebrew
    $ find Cellar
    Cellar/wget/1.16.1
    Cellar/wget/1.16.1/bin/wget
    Cellar/wget/1.16.1/share/man/man1/wget.1
    
    $ ls -l bin
    bin/wget -> ../Cellar/wget/1.16.1/bin/wget
  • Homebrew won’t install files outside its prefix and you can place a Homebrew installation wherever you like.

  • Trivially create your own Homebrew packages.

    $ brew create https://foo.com/foo-1.0.tgz
    Created /opt/homebrew/Library/Taps/homebrew/homebrew-core/Formula/foo.rb
  • It’s all Git and Ruby underneath, so hack away with the knowledge that you can easily revert your modifications and merge upstream updates.

    $ brew edit wget # opens in $EDITOR!
  • Homebrew formulae are simple Ruby scripts:

    class Wget < Formula
      desc "Internet file retriever"
      homepage "https://www.gnu.org/software/wget/"
      url "https://ftp.gnu.org/gnu/wget/wget-1.24.5.tar.gz"
      sha256 "fa2dc35bab5184ecbc46a9ef83def2aaaa3f4c9f3c97d4bd19dcb07d4da637de"
      license "GPL-3.0-or-later"
    
      def install
        system "./configure", "--prefix=#{prefix}"
        system "make", "install"
      end
    end
  • Homebrew complements macOS (or your Linux system). Install your RubyGems with gem and their dependencies with brew.

  • “To install, drag this icon…” no more. Homebrew Cask installs macOS apps, fonts and plugins and other non-open source software.

    $ brew install --cask firefox
  • Making a cask is as simple as creating a formula.

    $ brew create --cask https://foo.com/foo-1.0.dmg
    Editing /opt/homebrew/Library/Taps/homebrew/homebrew-cask/Casks/foo.rb
  • brew command documentation

    Image for: brew command documentation

    docs.brew.sh/Manpage

  • Further Documentation

    Image for: Further Documentation

    docs.brew.sh

  • Community Discussion

    Image for: Community Discussion

    Homebrew/discussions

  • Homebrew Blog

    Image for: Homebrew Blog

    brew.sh/blog

  • Homebrew Packages

    Image for: Homebrew Packages

    formulae.brew.sh

  • Analytics Data

    Image for: Analytics Data

    formulae.brew.sh/analytics

  • Donate to Homebrew

    Image for: Donate to Homebrew

    Homebrew/brew#donations

  • Homebrew was created by Max Howell. Website by Rémi Prévost, Mike McQuaid and Danielle Lalonde.