Running your first local build

To run a Bitrise build locally, you only need two things:

  1. The Bitrise CLI - here’s our installation guide.
  2. A build configuration: that is, a bitrise.yml file. Read more about it in our guide.

If you use, you can download your app’s bitrise.yml from there: open the Workflow Editor of the app on, 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: 1.3.1

  - MY_NAME: My Name

    - script@1.1.3:
        - content: echo "Hello ${MY_NAME}!"

This defines an Environment Variable with your name and a workflow called test. Now let’s see how to run this build!

  1. Open the Terminal or some other Command Line Interface 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!