layout: documentation title: Installing Bazel on macOS

Install Bazel on macOS (OS X)

Install Bazel on macOS (OS X) using one of the following methods:

Bazel comes with two completion scripts. After installing Bazel, you can:

Install using Homebrew

1. Install JDK 8

JDK 8 can be downloaded from Oracle's JDK Page. Look for “Mac OS X” under “Java SE Development Kit”. This will download a DMG image with an install wizard.

2. Install Homebrew on macOS (OS X)

Installing Homebrew is a one-time setup:

/usr/bin/ruby -e "$(curl -fsSL
https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. Install Bazel Homebrew Package

brew install bazel

You are all set. You can confirm Bazel is installed successfully by running bazel version.

You can later upgrade to newer version of Bazel with brew upgrade bazel.

Install with installer

We provide binary installers on our GitHub releases page

The installer only contains Bazel binary, some additional libraries are required to be installed on the machine to work.

1. Install JDK 8

JDK 8 can be downloaded from Oracle's JDK Page. Look for “Mac OS X” under “Java SE Development Kit”. This will download a DMG image with an install wizard.

2. Install XCode command line tools

Xcode can be downloaded from the Apple Developer Site, which will redirect to the App Store.

For objc_* and ios_* rule support, you must have Xcode 6.1 or later with iOS SDK 8.1 installed on your system.

Once XCode is installed you can trigger signing the license with the following command:

sudo gcc --version

3. Download Bazel

Download the Bazel installer for your operating system.

4. Run the installer

Run the installer:

The --user flag installs Bazel to the $HOME/bin directory on your system and sets the .bazelrc path to $HOME/.bazelrc. Use the --help command to see additional installation options.

5. Set up your environment

If you ran the Bazel installer with the --user flag as above, the Bazel executable is installed in your $HOME/bin directory. It's a good idea to add this directory to your default paths, as follows:

export PATH="$PATH:$HOME/bin"

You can also add this command to your ~/.bashrc file.

You are all set. You can confirm Bazel is installed successfully by running

bazel version