Skip to main content

Configuring HTTPS authorization

For private apps, you can authorize Bitrise to access your repository via an HTTPS URL, using a Personal Access Token. This is necessary for Bitrise to be able to clone your repository to the virtual machine when starting a new build. You can set up authorization:

To configure authorization for a repository with HTTPS URL:

  1. Create a Personal Access Token at your Git provider and save it.

    Fine-grained access

    The Personal Access Token needs to have read access to the repository. We recommend using fine-grained Personal Access Tokens that do not have any additional rights to the repository or your Git provider account.

  2. Open your app on Bitrise with a user that has the Admin role on the app's team.

  3. On the main page of the app, click on the App Settings icon: settings.svg.

  4. Make sure you have an HTTPS URL: on the left, select General, and in the Basic settings section, find the Repository URL.

  5. On the left, select Integrations.

  6. Select the Git provider tab.

  7. In the Personal Access Token section, click Change.

  8. In the pop-up window, add the Personal Access Token.

    Bitbucket username

    If your repository is on Bitbucket, you'll also have to provide your Bitbucket username.

  9. Once done, click Save changes.