---
url: /howto/connecting-to-issue-trackers/github-with-access-token.md
description: >-
  This article describes how you can import issues from GitHub via an access
  token
---

# How to Connect Teamscale's Issue Tracker to GitHub via Access Token

Teamscale integrates with GitHub via the *classic* access token.
This is used to connect Github for issue tracking purposes.
The guide for connecting the code on GitHub via an App can be found [here](../../connecting-version-control-system/github/index.md).

:::tip General Option Reference
This guide only covers the options specific to the GitHub issue tracker via Access Token.
A general overview of connector options is [available here](../../../reference/connector-options/#issue-tracker-connector-options).
:::

## Setup of the Github Connector

1. In GitHub, navigate to the settings page of your Github account.
   Open *Developer Settings* > *Personal access tokens* and choose *Tokens (classic)*.
   Click the button *Generate new token* and choose *Generate new token (classic)*.
   Here you can provide a name and details of your access token.

2. Select the scopes.
   * Choose the *repo* scope.

     ![Screenshot of the relevant GitHub Access Token Scopes](github-scopes.png)
   * Click *Generate token*.

:::warning Store the Token immediately
Store the newly generated token in a safe place, because it will not be accessible anymore once the page is closed.
:::

3. Back in Teamscale, go *Project Configuration* > *Projects* and edit or [create a project](../../creating-a-project/).
   In the *Connector Configuration* section, click `+` and choose *Issue Tracker* > *Github*.

   ![Screenshot of the selected GitHub Issue Tracker](github-issue-tracker.png)

4. Add a new account by clicking on the `+` icon next to the `Account` field.
   ![Screenshot of the Account Creation Button](github-create-account.png)

   The following fields are relevant:

   * `URI`: URL to the Github repository with the desired issues.
   * `Password or API Key`: Your access token that was created in step 1.

   ![Screenshot of the GitHub Account Creation Mask](github-account-creation.png)

   * Click *Save*.

5. Click `Save project` and wait for the finished reanalysis.

6. The issues can be found under *Activity* > *Issues*.