Initializing a Bitrise project locally

When you add a new app to Bitrise, we detect the type of your project and generate a basic bitrise.yml file for you, with Workflows that are appropriate for your project type.

With the Bitrise CLI, you can make this work on your own computer. You will need:

  1. Install the Bitrise CLI on your computer.

  2. Make sure you have both Go and Ruby installed.

  3. Make sure that $GOPATH/bin is added to $PATH on your computer.

    By default, your Go workspace is at $HOME/go/bin.

  4. Start the bitrise init plugin:

    bitrise init
  5. Wait while the plugin runs all available scanners to determine your project type.

  6. Depending on the detected project type, the scanner asks for some input. Follow the instructions.

    For example, with an iOS project, it asks the user to specify an export method:

    Select: ipa export method
    Please select from the list:
    [1] : app-store
    [2] : ad-hoc
    [3] : enterprise
    [4] : development
    (type in the option's number, then hit Enter) :

Based on the scanner outputs, the plugin generates a Bitrise configuration, with a bitrise.yml file. In the automatically generated workflows, every required input will have a valid value.

The plugin also generates a bitrise.secrets.yml file. You can store your Secrets in this file.