# How to Connect Teamscale to GitLab

Screenshot of the GitLab Plugin's Findings Badge

Teamscale integrates with GitLab using the available API and web hooks. No global configuration is required. To connect a project to code from a GitLab project, follow these steps:

  1. Ensure that the Teamscale instance base URL is configured correctly.

  2. Select the GitLab connector during project creation.

  3. Select or create an account for the GitLab server. The account's URL should point to the GitLab server's root URL (i.e., it is not project specific). The username can be empty (ignored). The password is a personal access token of a GitLab user with api scope. To obtain a personal access token in GitLab, navigate to your user's settings page and select the Access Tokens page.

  4. Complete project creation as usual, by providing the name of the GitLab project (e.g., my-user/my-project) and completing any other required fields. As the first step in project creation, Teamscale will register its web hook with the project. After this, Teamscale will automatically be informed about events in the project, such as pushes to the repository and changes to any merge requests.

Screenshot of the GitLab Plugin's Line Comments


If there are restrictions, so that Teamscale cannot receive GitLab web hooks or web hooks cannot be automatically created, please apply these advanced configuration options.