Skip to main content

Installing and updating the Bitrise CLI

The Bitrise CLI is Bitrise's open source runner. The CLI is used to run your builds on bitrise.io and you can install and run it on your own computer to run builds locally.

The Bitrise CLI is distributed as a single binary for macOS and Linux. You can download it using curl or Homebrew.

Installing the Bitrise CLI with curlClick to copy link​

  1. Run the following command in a bash shell:

    curl -fL https://github.com/bitrise-io/bitrise/releases/latest/download/bitrise-$(uname -s)-$(uname -m) > /usr/local/bin/bitrise

    You can check the latest release of the Bitrise CLI on its releases page.

  2. Make the downloaded binary executable:

    chmod +x /usr/local/bin/bitrise

  3. Run bitrise setup.

    This will verify if everything that is required for Bitrise to run is installed and available. If you skip this, the CLI will perform the setup anyway the first time you call bitrise run.

Installing the Bitrise CLI with HomebrewClick to copy link​

If you have the Homebrew package manager installed on your Mac, you can use it to install the Bitrise CLI.

  1. Open the Terminal app on your Mac and run:

    brew update && brew install bitrise

  2. Perform a first-time setup for the Bitrise CLI:

    bitrise setup

    This will verify if everything that is required for Bitrise to run is installed and available. If you skip this, the CLI will perform the setup anyway the first time you call bitrise run.

Updating the Bitrise CLIClick to copy link​

Updating the Bitrise CLI is easy, and it doesn’t matter if you installed it with Homebrew or from the GitHub release.

Simply run bitrise update - that’s it! The CLI checks for updates once every day and notifies you as soon as there is a new version.