Available environment variables

Environment Variables (Env Vars) consist of a key and a value, as well as optional attributes. They can be defined on the level of apps, Workflows or Steps.

You can set your own Env Vars but there is a selection of Env Vars that are exposed automatically by either the Bitrise CLI or bitrise.io.

  • Env Vars exposed by the Bitrise CLI are available everywhere, even if you run the build on your own computer.

  • Env Vars exposed by bitrise.io are available for builds running on bitrise.io virtual machines.

Table 1. Env Vars exposed by the Bitrise CLI

Env Var key

Description

$BITRISE_TRIGGERED_WORKFLOW_ID

The ID of the Workflow that was triggered. This Env Var is exposed regardless of whether the Workflow was triggered manually or automatically.

$BITRISE_TRIGGERED_WORKFLOW_TITLE

The title of the Workflow that was triggered. This Env Var is exposed regardless of whether the Workflow was triggered manually or automatically.

$BITRISE_BUILD_STATUS

The current status of the build. The available options are:

  • 0: Successful.

  • 1: Failed.

A successful current status means that none of the previous Steps in the build failed.

$BITRISE_SOURCE_DIR

Path to the base working directory. By default, it’s the directory where Bitrise runs, unless you provide a different value. This can be overwritten during the build, which will change the working directory for subsequent Steps in the build.

$BITRISE_DEPLOY_DIR

Path to the directory that stores artifacts and files for deployment. It’s a temporary directory created by the Bitrise CLI by default, and can be overwritten before starting the Bitrise CLI. The Deploy to Bitrise.io Step looks for your build artifacts - such as an IPA or APK of the app -, test results, and other files in this directory.

$CI

Indicates whether the Bitrise CLI is running in Continuous Integration mode. The possible values are:

  • true

  • false

$PR

Indicates whether the Bitrise CLI is running in PR (Pull Request) mode. Running in Pull Request mode means that Bitrise builds your code in the state as if the Pull Request was already merged. The possible values are:

  • true

  • false


Table 2. Env Vars exposed by bitrise.io

Env Var key

Description

$BITRISE_BUILD_NUMBER

Build number of the build on bitrise.io.

$BITRISE_APP_TITLE

The title of your app on bitrise.io. You can change it any time on the Settings tab of the app.

$BITRISE_APP_URL

The URL or your app on bitrise.io. This is not the same as the git repository URL! An app URL has the following format:

app.bitrise.io/APP-SLUG/

For example: https://app.bitrise.io/app/31e481ce08e0xfd9.

$BITRISE_APP_SLUG

The slug that uniquely identifies your app on bitrise.io. It’s part of the app URL, too.

$BITRISE_BUILD_URL

The URL of the build on bitrise.io.

$BITRISE_BUILD_SLUG

The slug that uniquely identifies a build on bitrise.io. It’s part of the build URL, too.

For example, let’s take a look at this build URL: https://app.bitrise.io/build/d75abbebxfc9ca4e. The build slug is d65abbebxfc9ca4e in this example.

$BITRISE_BUILD_TRIGGER_TIMESTAMP

The date and time when the build was triggered.

$GIT_REPOSITORY_URL

The URL of the Git repository that hosts your app. This can be changed in the Settings tab of the app. It can be in either SSH or HTTPS format.

$BITRISE_GIT_BRANCH

The git branch that is built by Bitrise. For example, main.

$BITRISEIO_GIT_BRANCH_DEST

Used only with builds triggered by pull requests: the destination/target branch of the pull request that triggered the build.

For example, a pull request wants to merge the content of a branch into the branch main. In this case, this Env Var’s value is main.

$BITRISE_GIT_TAG

If a build is triggered by a Git Tag, this Env Var stores the tag used.

$BITRISE_GIT_COMMIT

The commit hash of the Git commit that triggered the build, when applicable.

$BITRISE_GIT_MESSAGE

The commit message, pull request title, or the message you specified if you triggered the build manually.

$BITRISEIO_GIT_REPOSITORY_OWNER

The owner of the Git repository of the app.

$BITRISEIO_GIT_REPOSITORY_SLUG

The slug of the Git repository of the app.

$BITRISE_PULL_REQUEST

The ID of the pull request that triggered a build.

$BITRISEIO_PULL_REQUEST_REPOSITORY_URL

The URL of the repository from where the pull request that triggered a build has been sent.

$BITRISEIO_PULL_REQUEST_MERGE_BRANCH

The pre-merge branch - if the Git hosting provider supports and provides the pre-merged state of a pull request on a special merge branch.

$BITRISEIO_PULL_REQUEST_HEAD_BRANCH

The pull request head branch, if the Git hosting provider system supports and provides this. This special git ref should point to the source of the pull request.

$BITRISE_PROVISION_URL

The URL of the Apple provisioning profiles uploaded to bitrise.io. If there is more than one provisioning profile uploaded for your app, a pipe character (|) separates the URLs in the list.

This is only relevant for iOS apps and for cross-platform apps with iOS versions.

$BITRISE_CERTIFICATE_URL

The URL of the Apple certificates uploaded to bitrise.io. If there is more than one certificate uploaded for your app, a pipe character (|) separates the URLs in the list.

This is only relevant for iOS apps and for cross-platform apps with iOS versions.

$BITRISE_CERTIFICATE_PASSPHRASE

The passphrase you set for the uploaded Apple certificates on the app’s Code Signing tab. If there is more than one certificate with a passphrase, a pipe character (|) separates the phrases in the list.

This is only relevant for iOS apps and for cross-platform apps with iOS versions.

$BITRISE_IO

Indicates that the build is running in a bitrise.io environment. Value is set to true by Bitrise when it starts a build.