Connecting your GitHub/GitLab/Bitbucket account to Bitrise
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.
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 .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 .
-
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
. 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
.
Connecting a Git provider account from the Profile settings page
-
In the upper right corner, open the account selector dropdown menu.
-
Select the
option.This takes you to the Edit your profile page.
-
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
.
Disconnecting a Git provider account
-
In the upper right corner, open the account selector dropdown menu.
-
Select the
option.This takes you to the Edit your profile page.
-
On the left menu bar, click the toggle next to the name of the Git provider you wish to disconnect.