# GitLab Connection

To enable AquilaX to scan private GitLab repositories, you must grant the platform access to your GitLab account or self-hosted instance.

### Steps

1. **Log in** to your AquilaX account: <https://aquilax.ai>
2. **Go to your Organizations** page: <https://aquilax.ai/app/dashboard/pages/organizations/>
3. **Find the organization** you want to connect and click the **three-dot menu** next to it, then select **Manage**
4. On the **Configuration** page, scroll to the **Integrations** section
5. Under **GitLab**, click **+ Connect**
6. In the dialog that appears:
   * Enter your **GitLab instance URL** (either a public `gitlab.com` account or a private/self-hosted GitLab instance)
   * Enter your **GitLab Access Token** with the necessary permissions for repository access (the access granted must be at least `read_api` and `read_repository`, alternative you can select only `api`)\
     \\

     <figure><img src="https://53914109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjAmSnvnfbHl4EDK56iDo%2Fuploads%2Fgit-blob-17b75ecebcc313a2ad6fbb9f42d8eec6e9e1e585%2FScreenshot%202025-08-10%20at%2014.18.11.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
7. Click **Next** and select the **GitLab groups** you want to grant access to

<figure><img src="https://53914109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjAmSnvnfbHl4EDK56iDo%2Fuploads%2Fgit-blob-19318df9680d194b1f79377554f8ffec6b053641%2FScreenshot%202025-08-10%20at%2014.19.07.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Once connected, **refresh the page** to confirm the integration status and verify that AquilaX has access. You can now scan any repository from the connected groups\
\\

**Notes**

* If you have already connected your GitLab account, you can click View Details in the Integrations section to:

  • Update the connection details to refresh connection and list of repos

  • Delete the integration and start over
* Only Organization Owners can perform these operations