Skip to main content

Configuring the repository URL and default branch

Abstract

When adding a new app to Bitrise, you specify a repository that is used to store your source code, and a branch that Bitrise uses as the default branch. You can change these at any time from App Settings.

When adding a new app to Bitrise, you specify a repository that is used to store your source code, and a branch that Bitrise uses as the default branch.

Once the app is set up, you can change these at any time.

Changing the repository URL

The repository URL is the address where your repository can be accessed by Bitrise. It can be either an SSH URL or an HTTPS URL: we strongly recommend using SSH URLs for all private apps for security reasons.

Using an HTTPS URL

You can use HTTPS Git URLs, using a personal access token for authorization: in this case, you don't need an SSH key: Configuring HTTPS authorization.

If you move your project's repository, or the URL changes for any other reason, you can update it on Bitrise and continue building without an issue.

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

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

    app-settings.png
  3. From the menu on the left, select General.

    general-settings.png
  4. Click Edit.

  5. Find the Repository URL field.

    basic-settings-popup.png
  6. Enter the new URL.

  7. Click Save to save changes.

Changing the default branch

The default branch is the branch of your repository that Bitrise will use if no other configuration indicates otherwise.

You can change the default branch at any time.

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

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

    app-settings.png
  3. From the menu on the left, select General.

  4. Click Edit.

  5. Find the Default branch field.

    default_branch.png
  6. Type the name of the branch you want to use as default branch.

  7. Click Save to save changes.