Skip to main content

Installing and updating the Bitrise CLI

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 local 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 local 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 local 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 local 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.

Configuring the Bitrise CLIClick to copy link​

The CLI saves its settings to ~/.config/bitrise/cli/config.yml. Make sure ~/.config (or $XDG_CONFIG_HOME, if you set it) is writable. Otherwise, bitrise local setup and plugin commands can fail.

To learn about the config files and the settings you can save, see Configuring the Bitrise CLI.

See also