--- layout: documentation title: Installing Bazel --- # Installing Bazel Supported platforms: * [Ubuntu Linux (Wily 15.10 and Trusty 14.04 LTS)](#ubuntu) * [Mac OS X](#mac-os-x) * [Windows (highly experimental)](#windows) For other platforms, you can try to [compile from source](#compiling-from-source). Required Java version: * Java JDK 8 or later ([JDK 7](#jdk7) is still supported but deprecated). Extras: * [Bash completion](#bash) * [zsh completion](#zsh) For more information on using Bazel, see [Getting started](getting-started.html). ## Ubuntu Install Bazel on Ubuntu using one of the following methods: * [Using our custom APT repository](#install-on-ubuntu) * [Using binary installer](#install-with-installer-ubuntu) * [Compiling Bazel from source](#compiling-from-source) ### Using Bazel custom APT repository (recommended) #### 1. Install JDK 8 If you are running **Ubuntu Wily (15.10)**, you can skip this step. But for **Ubuntu Trusty (14.04 LTS)** users, since OpenJDK 8 is not available on Trusty, please install Oracle JDK 8: ``` $ sudo add-apt-repository ppa:webupd8team/java $ sudo apt-get update $ sudo apt-get install oracle-java8-installer ``` Note: You might need to `sudo apt-get install software-properties-common` if you don't have the `add-apt-repository` command. See [here](http://manpages.ubuntu.com/manpages/wily/man1/add-apt-repository.1.html). #### 2. Add Bazel distribution URI as a package source (one time setup) ``` $ echo "deb [arch=amd64] http://storage.googleapis.com/bazel-apt stable jdk1.8" | sudo tee /etc/apt/sources.list.d/bazel.list $ curl https://bazel.build/bazel-release.pub.gpg | sudo apt-key add - ``` If you want to use the JDK 7, please replace `jdk1.8` with `jdk1.7` and if you want to install the testing version of Bazel, replace `stable` with `testing`. #### 3. Install and update Bazel `$ sudo apt-get update && sudo apt-get install bazel` Once installed, you can upgrade to newer version of Bazel with: `$ sudo apt-get 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 **Ubuntu Trusty (14.04 LTS).** OpenJDK 8 is not available on Trusty. To install Oracle JDK 8: ``` $ sudo add-apt-repository ppa:webupd8team/java $ sudo apt-get update $ sudo apt-get install oracle-java8-installer ``` Note: You might need to `sudo apt-get install software-properties-common` if you don't have the `add-apt-repository` command. See [here](http://manpages.ubuntu.com/manpages/wily/man1/add-apt-repository.1.html). **Ubuntu Wily (15.10).** To install OpenJDK 8: ``` $ sudo apt-get install openjdk-8-jdk ``` #### 2. Install other required packages ``` $ sudo apt-get install pkg-config zip g++ zlib1g-dev unzip ``` #### 3. Download Bazel Download the [Bazel installer](https://github.com/bazelbuild/bazel/releases) for your operating system. #### 4. Run the installer Run the installer: 
$ chmod +x bazel-version-installer-os.sh
$ ./bazel-version-installer-os.sh --user
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: ```bash $ export PATH="$PATH:$HOME/bin" ``` You can also add this command to your `~/.bashrc` file. ## Mac OS X Install Bazel on Mac OS X using one of the following methods: * [Using Homebrew](#install-on-mac-os-x-homebrew) * [Using binary installer](#install-with-installer-mac-os-x) * [Compiling Bazel from source](#compiling-from-source) ### Using Homebrew #### 1. Install Homebrew on Mac OS X (one time setup) `$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"` #### 2. Install Bazel Homebrew Package `$ brew install bazel` Once installed, you can 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](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html). Look for "Mac OS X x64" 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](https://developer.apple.com/xcode/downloads/), 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](https://github.com/bazelbuild/bazel/releases) for your operating system. #### 4. Run the installer Run the installer: 
$ chmod +x bazel-version-installer-os.sh
$ ./bazel-version-installer-os.sh --user
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: ```bash $ export PATH="$PATH:$HOME/bin" ``` You can also add this command to your `~/.bashrc` file. ## Windows Windows support is highly experimental. Known issues are [marked with label "Windows"](https://github.com/bazelbuild/bazel/issues?q=is%3Aissue+is%3Aopen+label%3A%22category%3A+multi-platform+%3E+windows%22) on GitHub issues. We currently support only 64 bit Windows 7 or higher and we compile Bazel as a msys2 binary. Install Bazel on Windows using one of the following methods: * [Using Chocolatey](#install-on-windows-chocolatey) * [Using binary distribution](#download-binary-windows) * [Compiling Bazel from source](#compiling-from-source) -- make sure your machine meets the [requirements](windows.md#requirements) ### Install on Windows using Chocolatey You can install the unofficial package using the [chocolatey](https://chocolatey.org) package manager: ```sh choco install bazel ``` This will install the latest available version of bazel, and dependencies. This package is experimental; please provide feedback to `@petemounce` in GitHub issue tracker. See the [Chocolatey installation and package maintenance](windows-chocolatey-maintenance.md) guide for more information. ### Download a precompiled binary We provide binary versions on our GitHub releases page This is merely the Bazel binary. You'll need additional software (e.g. msys2 shell) and some setup in your environment to run Bazel. See these requirements on our [Windows page](windows.md#requirements). ## Compiling from source The standard way of compiling a release version of Bazel from source is to use a distribution archive. Download `bazel--dist.zip` from the [release page](https://github.com/bazelbuild/bazel/releases) for the desired version (for releases 0.4.0 and earlier: download the "source code" zip archive and note that it will only work for the supported architectures as it contains binaries). We recommend to also verify the signature made by our [release key](https://bazel.build/bazel-release.pub.gpg) 48457EE0. Unzip the archive and call `bash ./compile.sh`; this will create a bazel binary in `bazel-bin/src/bazel`. This binary is self-contained, so it can be copied to a directory on the PATH (e.g., `/usr/local/bin`) or used in-place. ## Using Bazel with JDK 7 (deprecated) Bazel version _0.1.0_ runs without any change with JDK 7. However, future version will stop supporting JDK 7 when our CI cannot build for it anymore. The installer for JDK 7 for Bazel versions after _0.1.0_ is labeled 
./bazel-version-jdk7-installer-os.sh
If you wish to use JDK 7, follow the same steps as for JDK 8 but with the _jdk7_ installer or using a different APT repository as described [here](#1-add-bazel-distribution-uri-as-a-package-source-one-time-setup). ## Getting bash completion Bazel comes with a bash completion script. To install it: 1. Build it with Bazel: `bazel build //scripts:bazel-complete.bash`. 2. Copy the script `bazel-bin/scripts/bazel-complete.bash` to your completion folder (`/etc/bash_completion.d` directory under Ubuntu). If you don't have a completion folder, you can copy it wherever suits you and simply insert `source /path/to/bazel-complete.bash` in your `~/.bashrc` file (under OS X, put it in your `~/.bash_profile` file). ## Getting zsh completion Bazel also comes with a zsh completion script. To install it: 1. Add this script to a directory on your $fpath: ``` fpath[1,0]=~/.zsh/completion/ mkdir -p ~/.zsh/completion/ cp scripts/zsh_completion/_bazel ~/.zsh/completion ``` 2. Optionally, add the following to your .zshrc. ``` # This way the completion script does not have to parse Bazel's options # repeatedly. The directory in cache-path must be created manually. zstyle ':completion:*' use-cache on zstyle ':completion:*' cache-path ~/.zsh/cache ```