Contact UsGet started

GitHub

Written by
Updated at October 29, 2024

In Tracker issues, you can automatically add links to commits from GitHub. To do this, specify the appropriate issue's key in the commit comment. The links will be placed on the Commits tab.

Connecting a repository

To connect your repository on GitHub to Tracker:

  1. Make sure you are authorized in Tracker as an administrator.

  2. In the left-hand panel, click and select Admin settings → Repositories → Connect.

  3. Choose GitHub in the Platform field.

  4. Enter the public repository address in the https://github.com/<repository_owner_login>/<repository_name> format. Leave the Token field blank.

  5. Click Connect.

  6. Make sure that the repository status in Tracker is Connected.

  1. Make sure you are authorized in Tracker as an administrator.

  2. In the left-hand panel, click and select Admin settings → Repositories → Connect.

  3. Choose GitHub in the Platform field.

  4. Get an OAuth token for your repository on GitHub:

    • Log in to GitHub. If the repository is linked to an organization on GitHub, make sure that you have admin rights for it.

    • Click your profile picture in the top-right corner and select Settings.

    • In the left-hand panel, select Developer settings → Personal access token → Tokens (classic).

    • Click Generate new token.

    • Enter a name for the token.

    • Configure permissions for the token. For Tracker to operate properly, enable the repo and read:org options:

    • Click Generate token.

    • Copy the token to the clipboard.

      Alert

      The token value is displayed only once. If you close the page, you will not be able to view it again.

  5. Enter the repository address in the https://github.com/<repository_owner_login>/<repository_name> format and specify the access token.

  6. Click Connect.

  7. Make sure that the repository status in Tracker is Connected.

To link a commit to an issue, specify the issue key in the comment to the commit.

Note

Please note that it takes some time for a commit to get linked to an issue.

To view the linked commits, select Show the Commits tab in the queue settings. You can view the linked commits:

  • In the Commits tab on the issue page.
  • On the queue commits page. To switch to the commits page from the queue page, click → Commits in the top-right corner.

Own server

To connect your own server to Tracker:

  1. Make sure you are authorized in Tracker as an administrator.

  2. In the left-hand panel, click and select Admin settings → Repositories → Connect.

  3. In the Platform field, select the platform your server is connected to.

  4. In the Link to repository field, specify your server address to any repository that can be accessed using a token.

  5. Get an OAuth token for your repository on GitLab. For details on how to get a token, see the GitLab documentation. For the proper operation of Tracker, enable the read_repository and read_api options when setting up permissions.

  6. In the Token field, enter the token for connecting to your server.

  7. Click Connect.

  8. Make sure that the repository status in Tracker is Connected.

Previous
Bitbucket
Next
GitLab