How to enable the GitHub integration
You can enable the GitHub integration for your Tettra account through the team integrations page.
GitHub is installed at the team level, so everyone can use it once the integration is enabled. Only a GitHub admin may install the integration, and this person must also be a Tettra editor or Admin (i.e., not a Guest or Read-only user).
Step 1. Team integrations
- Click your team's name to access the dropdown menu, then click Team settings.
- Click Team integrations.
- Choose GitHub:
Step 2. Installation flow
This will take you to the GitHub app installation flow. Click Install.
Step 3. Install
On the confirmation screen, choose your GitHub account and log in, then select the repositories you'd like to give Tettra access to. Click Install.
The permissions Tettra requires from GitHub are:
- Read access to metadata
- Read and write access to issues
These permissions allow Tettra to search for issues and their content since GitHub doesn't allow any access to code. We also request write access to issues so that we can backlink from them to the Tettra page.
Step 5. Select repositories
After selecting your repositories and clicking install, you'll be redirected back to the integrations page. You can go back anytime to edit which repositories are connected (or uninstall completely, should you wish).
