Starting builds manually

Last updated at 2020-06-12

Starting a build manually on Bitrise takes literally two clicks - if you leave everything on the default settings. If you do not wish to do that, or at least want to be sure what the default settings are, read on! We’ll walk you through the process.

  1. Log in to Bitrise and go to the Dashboard.
  2. Select the app you wish to build.
  3. Click Start/Schedule a Build.

    Starting builds manually

At this point, the Build configuration window opens and you are presented with two tabs near the top of the window:

Scheduling builds

The Schedule this build option allows you to configure builds to be triggered at specific times. Read more in our guide.

Basic configuration

If you choose Basic in the Build configuration window, you have three options to configure:

Starting builds manually

Pull request build

Starting a build of a pull request’s branch is NOT the same as a pull request build. The manually started build of a pull request branch will only build the state of the code on that branch. An automatically triggered pull request build, however, builds the state of the code as it will look like once you merged the pull request.

Advanced configuration

If you choose Advanced in the Build configuration window, you have all the options available with Basic, and a few more:

Starting builds manually

Conflicting input

If, for example, you specify a commit hash, you will notice that the Git Tag option disappears. This ensures that you cannot enter conflicting input values.

If you specify a commit hash and a branch where that commit does not exist (for example, master), Bitrise will find the branch that does have the given commit (for example, testing) and run a build with that branch.