---
url: /reference/admin-settings/github-integration.md
---

# GitHub Applications

Teamscale supports integration with GitHub through GitHub Apps which enables both signing in via GitHub accounts and [Teamscale's pull request integrations](../../connector-options/#vote-supporting-connector-options).
GitHub Apps can be configured for both github.com and GitHub Enterprise Server instances.

To add an App, go to *Admin > Settings > GitHub Integration* and click on `+ Add` under `GitHub Application`.
A dialog asking for a `GitHub Application ID` will open.
This ID is only used as a unique identifier within Teamscale and does not have to match anything in GitHub.
After clicking on *Ok*, a new App will be created and the following configuration options will be available.

:::tip How to Set Up a GitHub Application
For more detailed instructions on setting up a GitHub Application, see our [how-to guide](../../../howto/connecting-version-control-system/github/).
:::

## Configuration Options

## GitHub Team Synchronization

GitHub team synchronization allows you to use GitHub teams to manage access control in Teamscale.
When enabled and a user logs into Teamscale using GitHub, their team memberships from your GitHub organizations are automatically synchronized to Teamscale groups, allowing you to:

* Use GitHub teams to control who has access to Teamscale projects
* Automatically grant or revoke access based on team membership changes in GitHub
* Maintain a single source of truth for team membership in GitHub
