# Connect Tessl to GitHub

To enable Tessl on your repositories, you will first navigate to the [Tessl Registry](https://tessl.io/registry) and login, if required.

## Enabling the Integration

* Select your workspace from the selector on the left side menu.\
  ![](/files/V9nMMDmUKpXSLQJrnvrE)
* Click on Integrations from the menu\
  ![](/files/pkYZPOonwKVCpyyOrzeC)

  .
* Select *Enable Integration*.<br>

  <div align="left"><figure><img src="/files/nBLnGrcqANHSAXoyXDOw" alt="" width="375"><figcaption></figcaption></figure></div>
* Select *Configure* next to the Organization to add the Tessl App to. Accounts that already have Tessl will not have the option.

  <div align="left"><figure><img src="/files/892jONSNB5kRh0MzTxrW" alt="" width="563"><figcaption></figcaption></figure></div>
* Decide if you want to authorize Tessl on specific repositories or provide access to everything. Once selected, click *Install & Authorize*

  <div align="left"><figure><img src="/files/rIPje4QWB2aIpGT5fgYW" alt="" width="375"><figcaption></figcaption></figure></div>
* If the required permissions are available the Tessl integrations screen will show Connected.

  <div align="left"><figure><img src="/files/5K8xV5vxOmjXeeeujUSp" alt="" width="375"><figcaption></figcaption></figure></div>

## Add or remove Repositories when *Only Select Repositories* are in use.

If you wish to later add repositories, you will navigate to the Tessl app in GitHub:

* Click *Configure* next to the Tessl App.

  <div align="left"><figure><img src="/files/mdW1HF0JOo1PhAiXwW1R" alt=""><figcaption></figcaption></figure></div>
* Select or remove repositories as needed.

  <div align="left"><figure><img src="/files/SXglBk4RJOUV1plC21I9" alt="" width="375"><figcaption></figcaption></figure></div>
* Click *Save*.<br>

  <div align="left"><figure><img src="/files/fneaTQ8PR6xtyM6Qb0oq" alt="" width="81"><figcaption></figcaption></figure></div>

## Troubleshooting

What if the option to *Enable Integration* isn't available? In the following example Tessl is not enabled and the user does not have the correct [Role](/administrators/roles.md) within Tessl (manager or owner) so the interface does not provide the option to integrate GitHub. To address this, ensure you have the correct [Role](/administrators/roles.md) within Tessl or request a user with these permissions to setup the integration.

<div align="left"><figure><img src="/files/c0ybEshXUBijPM753ds1" alt="" width="375"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tessl.io/distribute/rollout-to-your-repositories/connect-tessl-to-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
