> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Connect Tessl to GitLab

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 workspace switcher in the sidebar, below the organization dropdown.\
  ![](</gitbook-assets/image (115).png>)
- Open **Settings** in the sidebar, then select the **Integrations** section\
  ![](</gitbook-assets/image (116).png>)

  .

  If the integration belongs to your organization rather than this workspace, the workspace Integrations section only summarizes it. Manage the connection from the organization dropdown at the top of the sidebar → **Settings** → **Integrations** → **Manage**. This route needs the organization integration-management permission.
- Select _Add_ next to the GitLab integration.

<figure><img src="/gitbook-assets/gitlab-integration-add.png" alt=""><figcaption></figcaption></figure>

- Provide an access token with the correct [permissions](/guides/distribute/rollout-to-your-repositories/permissions.md#gitlab-permissions) for a gitlab.com instance. \* If you are using a self hosted or customer-url for your instance, check the Use a custom instance URL box, and provide the necessary URL.<br>

  ```
  <div align="left"><figure><img src="/gitbook-assets/image (2).png" alt="" width="375"><figcaption></figcaption></figure></div>
  ```

## Troubleshooting

What if the option to _Add 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 GitLab. 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.

<figure><img src="/gitbook-assets/image (4).png" alt=""><figcaption></figcaption></figure>