Connecting repositories

Restriction. Repositories can only be connected by your organization's administrator.

Connecting your repositories to Tracker lets you link commits to issues. You can link any number of repositories hosted on GitHub, GitLab, and Bitbucket.

Restriction. Git repositories hosted on your own private server can't be linked to Tracker.

GitHub

Follow these steps to link a GitHub repository to Tracker:

Make sure that you are logged in as the organization administrator in Yandex Connect.
Choose → Tracker settings on the upper panel.
Open the Repositories tab and click Enable repository.
Choose GitHub in the Platform field.
Enter the public repository's address using the format https://github.com/<repository owner login>/<repository name>. Leave the Token field blank.
Click Activate.
Make sure your repository's status in Tracker says Connected.

Make sure that you are logged in as the organization administrator in Yandex Connect.
Choose → Tracker settings on the upper panel.
Open the Repositories tab and click Enable repository.
Choose GitHub in the Platform field.
Go to GitHub and receive an OAuth token for your repository:
- Log in to GitHub. If your repository is connected to a GitHub organization, make sure you have admin rights.
- Click your picture in the upper-right corner and choose Settings.
- In the left-hand panel, select Developer settings → Personal access token.
- Click Generate new token.
- Choose a name for your token.
- Configure access rights for your token. To make sure Tracker operates correctly, enable the repo and read:org options:
- Click Generate token.
- Copy the token to the clipboard.
  
  Attention. Your token will only be displayed once. You won't be able to see it again after closing the page.
Enter the public repository's address using the format https://github.com/<repository owner login>/<repository name> and specify the access token.
Click Activate.
Make sure your repository's status in Tracker says Connected.

To link a commit to an issue in Tracker, specify the issue key in the comments for the commit. You can view linked commits the following ways:

On the Commits tab on the issue page.
On the Commits tab on the queue page.

If you don't see the Commits tab, make sure it's enabled in your queue settings.

GitLab

Follow these steps to link a GitLab repository to Tracker:

Make sure that you are logged in as the organization administrator in Yandex Connect.
Choose → Tracker settings on the upper panel.
Open the Repositories tab and click Enable repository.
Choose GitLab in the Platform field.
Enter the public repository address using the format https://gitlab.com/<repository owner login>/<repository name>. Leave the Token field blank.
Click Activate.
Make sure your repository's status in Tracker says Connected.

Note. Private repositories can only be accessed by users logged in to GitLab (Internal project) or the project team (Private project).

Make sure that you are logged in as the organization administrator in Yandex Connect.
Choose → Tracker settings on the upper panel.
Open the Repositories tab and click Enable repository.
Choose GitLab in the Platform field.
Go to GitLab and receive an OAuth token for your repository:
- Log in to GitLab.
- Click your picture in the upper-right corner and choose Settings.
- On the left panel, select Access Tokens.
- Enter your token's name in the Name field.
- Set the token expiration date in the Expires at field.
- Configure the token's access rights. To operate Tracker correctly, enable the api option:
- Click Create personal access token.
- Copy the token to the clipboard.
  
  Attention. Your token will only be displayed once. You won't be able to see it again after closing the page.
Enter the public repository's address using the format https://gitlab.com/<repository owner's login/repository name and specify the access token.
Click Activate.
Make sure your repository's status in Tracker says Connected.

To link a commit to an issue in Tracker, specify the issue key in the comments for the commit. You can view linked commits the following ways:

On the Commits tab on the issue page.
On the Commits tab on the queue page.

If you don't see the Commits tab, make sure it's enabled in your queue settings.

Bitbucket

Follow these steps to link a Bitbucket repository to Tracker:

Make sure that you are logged in as the organization administrator in Yandex Connect.
Choose → Tracker settings on the upper panel.
Open the Repositories tab and click Enable repository.
Choose Bitbucket in the Platform field.
Create a Tracker password in Bitbucket. Tracker will use this password to connect to your repositories.
- Log in to Bitbucket.
- Click your photo in the bottom left corner and choose Bitbucket settings.
- Choose App passwords in the Access management block.
- Click Create app password.
- Think of a name for your password (e.g. Tracker integration password).
- Set access rights for your password. To operate Tracker correctly, enable the read option in the Repositories block:
- Click Create.
- Copy the password to clipboard.
  Attention. Your password will only be displayed once. You won't be able to see it again after closing the page.
Enter the repository's address using the format https://bitbucket.org/<repository owner's login/repository name and specify your Bitbucket login.
Enter the password you used when linking Tracker to Bitbucket. You cannot use your personal Bitbucket password.
Click Activate.
Make sure your repository's status in Tracker says Connected.

To link a commit to an issue in Tracker, specify the issue key in the comments for the commit. You can view linked commits the following ways:

On the Commits tab on the issue page.
On the Commits tab on the queue page.

If you don't see the Commits tab, make sure it's enabled in your queue settings.

Contact support