Running your first local build with the CLI

To run a Bitrise build locally, you only need to:

  1. Install the Bitrise CLI.

  2. A build configuration: that is, a bitrise.yml file.

If you use bitrise.io, you can download your app’s bitrise.yml from there: open the Workflow Editor of the app on bitrise.io, under the bitrise.yml section.

If you want to create a bitrise.yml yourself, simply create a bitrise.yml file in the root of your project. You can use this as the base content of the bitrise.yml:

format_version: 11
default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git

app:
  envs:
  - MY_NAME: My Name

workflows:
  test:
    steps:
    - script@1.1.3:
        inputs:
        - content: echo "Hello ${MY_NAME}!"

This defines an Environment Variable with your name and a workflow called test. To run this build:

  1. Open the Terminal or some other CLI app.

  2. Go to the directory where you saved the bitrise.yml file.

  3. Run bitrise run with the name of the workflow you defined in the file.

     bitrise run test

That’s it: your first build is running with the Bitrise CLI.