When adding an application, if youโ€™re using a private Git repository, you must select a Git provider and repository from your account. In addition to Bitbucket, you can also choose from GitHub or GitLab. If youโ€™re using Bitbucket and want to use GitHub repositories, youโ€™ll need to import the repository from GitHub. Later in this guide, weโ€™ll show you how to import a GitHub repository into Bitbucket.
For security, your Git account creation date must be more than 30 days. If it is less than 30 days and you want to connect the Git account to Sevalla, please contact Sevallaโ€™s Support Team.

Grant access to the Sevalla Bitbucket application

The first time you add an application in Sevalla, youโ€™ll need to connect to a git provider so that Sevallaย can access your applicationโ€™s repository. When you click Add application, you must choose your git provider and connect Sevallaย to your account.
You can only connect one Bitbucket account to each Sevalla user. If you want to connect a different Bitbucket account, you must remove Sevalla access to Bitbucket and reconnect to the other Bitbucket account.

Connect Sevalla with your Bitbucket account.

If you arenโ€™t logged in to Bitbucket, youโ€™ll need to log in. On the next page, youโ€™ll need to confirm Kinstaโ€™sย access to your Bitbucket account.
There may be occasions where you need to re-authenticate your Bitbucket account, for example, when we release an update to the Bitbucket integration or if the token has expired. You can view the expiration date for the token in your User settings (click on your username and go to User settings > Access).

Confirm Kinsta's access to connect to your Bitbucket account.

You may notice that the confirmation process is facilitated by Kinsta. Donโ€™t worry, as Sevalla is a Kinsta product, this is a normal part of the Sevalla experience. Youโ€™ll still be interacting with Sevallaโ€™s features and services. Just follow the prompts to complete the confirmation, and youโ€™ll be all set!
You will be returned to Sevalla. In Application details, select your applicationโ€™s Bitbucket repositoryย and Default branch. Then continue with the rest of the Add application steps.

Remove Sevallaย access to Bitbucket

To remove Sevallaโ€™s access to your Bitbucket account, youโ€™ll need to revoke access in your User settingsย in Sevalla and in Bitbucket:
  1. In Sevalla, click on your username and go to User settingsย > Access.ย In Application access, click Revokeย for the Bitbucket application.
  2. In Bitbucket, click on the gear icon and select Personal Bitbucket settings. Click on App authorizationsย under Access Management and click Revoke next to the Kinsta application.

Importing a GitHub repository

  1. Find the repository you want to use from Sevallaโ€™s example repositories at GitHubย and copy the URL.
  2. In Bitbucket, click Create >ย Repositoryย > Import repository.

Create a new repository at Bitbucket.

  1. Paste the URL of the Sevalla repository in the URL field, select the Project you want to add it to, and click Import repository.

Import a repository to Bitbucket.

  1. When the import is complete, you can start using the repository in Bitbucket.

Importing repository progress in Bitbucket.

Troubleshooting

Missing repositories

If youโ€™re having trouble seeing your repositories in the Add applicationย modal/pop-up, you may need to re-authorize Sevallaโ€™sย access to Bitbucket. To do that, start by removing access between Sevalla and Bitbucketย as described above. In Sevalla, in the Add applicationย modal/pop-up (Add serviceย > Add application), go through the authenticate and grant access steps to connect Sevallaย to your Bitbucket account again.

Conflicting namespaces

The Conflicting namespaces error appears when a Git account is connected to another Sevalla user account. Your Git account can only be linked to one Sevalla account; if you have multiple Sevalla accounts, you must use multiple Git accounts. To resolve this error, you must log in to your other Sevalla account and remove Sevalla access to Bitbucket.