site logo

Tettra Help Docs

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

  1. Click your team's name to access the dropdown menu, then click Team settings.
  2. Click Team integrations.
  3. Choose GitHub:


zgNgtxvGARJNA4ikICb9XSvHAvIfcBGkWQWpzwLZ.png


Step 2. Installation flow

This will take you to the GitHub app installation flow. Click Install.

 

lGsGMawLWAV3AEgmsClS7ccliZuuytxvHNUpkPhA.png


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.

 

cQobOlbLBTr0mw2zaPe3yY948bst0t5CWHwLAXbR.png


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).  
 

Lvho4yccZ7R5GDLo1kPvtEhIcIK1btRKNNTktdzi.png