Connecting your GitHub/GitLab/Bitbucket account to Bitrise

Abstract

To take full advantage of all the features Bitrise offers, including automatic webhook registration, you need to connect your GitHub/GitLab/Bitbucket account to your Bitrise account.

Connecting your GitHub/GitLab/Bitbucket account to your Bitrise account registers an OAuth application to your Git provider that allows Bitrise access to the repositories belonging to the account. This allows Bitrise to:

List the available repositories when adding a new app.
Automatically register webhooks. Webhooks allow setting up build triggers and enable the use of Git Insights.
Automatically register SSH keys.

You can connect all three Git provider accounts to your Bitrise account, by one of two methods:

Connecting the account when adding a new app.
Connecting the account from your Profile settings page.

One account per Git provider

Please note that you cannot connect two accounts from the same Git provider (for example, two GitHub accounts) to Bitrise.

Connecting one Git provider account is not final. You can disconnect an account and connect a different one at any time: Linked the wrong Git account to Bitrise.

Connecting a Git provider account when adding an app

Log in to your bitrise.io account.
Click the + symbol on the top menu bar and select Add New App on the web UI.

Adding a new app from a CLI

You can also add a new app using CLI. For more information, check out Adding a new app from a CLI.
On the Create New App page, select the account and set the app’s privacy setting.
Use the radio buttons under the Select repository section to choose between selecting a remote repository or entering an URL manually.

If you opt to enter a git URL manually, add it in the Git repository (clone) URL field and click Next.
Choose the Git service provider of the app’s repository, if you chose to select a remote repository. If no account with that provider has been connected to your Bitrise account, the UI will display the option to connect.
Click Connect account. This will take you to the login page of the Git provider.
Log in to the Git provider account.
You should be prompted to authorize bitrise.io - do it! If successful, you should be redirected to Bitrise, and a pop-up message should inform you that you successfully linked the account. Click Okay.

Connecting a Git provider account from the Profile settings page

In the upper right corner, open the account selector dropdown menu.
Select the Account settings option.
On the left menu bar, click the toggle next to the name of the Git provider you wish to connect.
Log in to the Git provider account.
You should be prompted to authorize bitrise.io - do it! If successful, you should be redirected to Bitrise, and a pop-up message should inform you that you successfully linked the account. Click Okay.

Disconnecting a Git provider account

In the upper right corner, open the account selector dropdown menu.
Select the Account settings option.
On the left menu bar, click the toggle next to the name of the Git provider you wish to disconnect.

In this section: