---
metadata:
- name: generator
content: Diplodoc Platform v5.47.3
alternate:
- https://yandex.com.tr/support/tracker/en/user/bitbucket.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/tracker/en/llms.txt
# Bitbucket
You can integrate your Bitbucket repository with Yandex Tracker to display links to commits in issues.
To add a commit link to an issue, specify the [issue key](*issuekey) in the commit comment, for example, `Fixing error TEST-123`. The link will appear in the issue's **Commits** tab. For more information, see [Integration with repositories](https://yandex.com.tr/support/tracker/en/user/add-repository.md).
{% note warning "" %}
Bitbucket supports Yandex Tracker integration only through periodic repository polling.
Links to commits may appear in Yandex Tracker with a delay of up to 10 hours.
{% endnote %}
## Integrating an online repository {#repo}
To integrate your online repository on Bitbucket to Yandex Tracker:
1. Obtain an API token on Bitbucket to access your repository:
- Log in to [Bitbucket](https://bitbucket.org).
- In the upper-right corner of the page, click the gear icon and select **Atlassian account settings**.
- Open the **Security** tab, go to **API tokens**, and click **Create and manage API tokens**.
- Click **Create API token with scopes**.
- Specify the token name and expiry date.
- Select **Bitbucket** as the app.
- Configure permissions for the token. Enable the `read:repository:bitbucket` option for Yandex Tracker integration.
- Check that you've entered everything correctly and click **Create token**.
- Copy the token you just created.
{% note alert "" %}
The token value is displayed only once — remember to save it. If you close the page, you will not be able to view it again.
{% endnote %}
1.
Make sure you are authorized in Tracker as an [administrator](https://yandex.com.tr/support/tracker/en/role-model.md).
1.
In Yandex Tracker, in the left-hand panel, click → **Administration** and then open **Repositories**.
1. Click **Add** and select **Repository**.
1. Choose Bitbucket in the **Platform** field.
1. Choose **bitbucket.org** for the **Server address** option.
1. In the **Repository** field, enter the address in this format: `https://bitbucket.org//`.
1. In the **Login** field, enter `x-bitbucket-api-token-auth`.
1. In the **Password** field, insert the token you obtained.
1. Click **Add**.
1. Make sure that the repository status in Yandex Tracker is **Connected**.
## Integrating an on-premises repository {#on-premise}
Before continuing, obtain a token to access the repository. For details on how to obtain an OAuth token, see the [Bitbucket documentation](https://support.atlassian.com/bitbucket-cloud/docs/use-oauth-on-bitbucket-cloud/).
To integrate an on-premises repository with Yandex Tracker:
1.
Make sure you are authorized in Tracker as an [administrator](https://yandex.com.tr/support/tracker/en/role-model.md).
1.
In Yandex Tracker, in the left-hand panel, click → **Administration** and then open **Repositories**.
1. Click **Add** and select **Repository**.
1. In the **Platform** field, select the type of your repository.
1. Choose **Own** for the **Server address** option.
1. In the **Repository** field, specify the URL of the repository on your server. Make sure that you connect to the server using the OAuth 2.0 technology.
1. In the **Token from platform** field, enter the token for connecting to your server.
1. Click **Add**.
1. Make sure that the repository status in Yandex Tracker is **Connected**.
[*issuekey]: An issue key is a unique identifier contained in the issue link. It consists of the queue key and a number, for example `TEST-123`.