Getting started

Signing up for Bitrise

Signing up with either of the Git service providers means you connect your Bitrise account to your account on that service provider. With a connected account, you can grant Bitrise access to any of your repositories on that account.

After signing up, you can connect your Bitrise account to all of the three supported Git service providers. For example, after you signed up with GitHub, you can connect your Bitrise account to both your GitLab and Bitbucket accounts, too, and access any repositories you have on those accounts.

Creating your first Workspace

After signing up, you will be prompted to create your first Workspace. A Workspace is an environment that allows you to manage your Bitrise apps and the team members working on the apps. You need a Workspace to be able to add an app and start running builds. You can create multiple Workspaces, and you can be invited to Workspaces by other Bitrise users.

To sign up for a paid subscription of your own, you need to create your own Workspace. Check our Pricing page for more information.

Adding a new app

Adding a new app to Bitrise means that you connect a Git repository to Bitrise, allowing us to clone the repository and then build it.

Add a new app any time by clicking the + symbol on the top menu bar and then selecting Add app from the dropdown menu.

Adding a new app

As part of the initial configuration process, you:

  • Decide if an app is private or public. Private app data is only available to those who are invited to work on the app. About public apps, read our Public apps guide.

  • Specify the repository: it can be either a GitHub, GitLab or Bitbucket repository, a manual repository URL, or a self-hosted GitLab repository.

  • Register an SSH key: this gives Bitrise access to the repository so we can clone it during the build process.

  • Specify the branch that you want to build.

You can change all this later - and anyway, adding a new app takes a couple of minutes so you can always just do the process from scratch.

As part of the process, Bitrise will scan and validate your repository and set up an app configuration based on the results of the scan: we can detect the platform type of your app based on the configuration files. If the validation fails, you can set up the app manually.

Read the details of the process in our Adding a new app guide.

Webhooks and triggers

You can set up webhooks as part of the process of adding a new app, or at any time later. Webhooks allow Bitrise to communicate with third party services: for example, a Bitrise webhook set up on a GitHub repository allows Bitrise to start a build automatically when code is modified in the repository.

Once webhooks are set up, configure when to start builds automatically by defining triggers. You can set:

  • The event which should trigger the build: for example, code push or a pull request.

  • The branch of your repository that can trigger builds: for example, master or dev.

Getting started

This means that you can, for example, set up a trigger that starts a build when a pull request is opened to the master branch.

Webhooks are required for triggers to work! Read more about webhooks in our Webhooks guide and about triggers in our Triggering builds guide.

Builds and Workflows

Once you added an app, your first build will be kicked off automatically. To view your builds, go to your Dashboard - which is the first page once you log in to Bitrise -, select the app and click the Builds tab to access your builds.

A build is a series of jobs, executed in the order defined in the app’s Workflow Editor. The jobs are called Steps, which represent blocks of script execution. The Steps can be arranged on the graphical UI of the Workflow Editor and they can do a huge number of things: clone your repository, build your app, run tests, pass values to each other, send notification messages to developers.

Getting started

Read more about Workflows and Steps in our relevant guides:

  • Workflows

  • Steps

A build's logs can be viewed on the build’s page: go to the Builds tab and select the build you want.

All builds run in clean virtual machines that are discarded after the build is complete. Read more about them in our Virtual machines guide.

Testing and deploying

Testing your app and deploying your app are both done with the help of our Steps: we have Steps dedicated to both these functions, based on the platform type. Unit testing, UI testing, and real device testing are all possible on Bitrise.

Once your app is tested, built and ready to go, you can quickly deploy it to the store of your choice, for example, Google Play or the App Store. Check out Ship, our fast and efficient deployment solution: Deploying with Ship.