# How to Connect Teamscale to GitLab

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 public base URL is configured correctly in Teamscale. For this, open the settings page ( Admin / Settings ) and check the entry Teamscale instance base URL in tab Server Settings . This should point to the URL of the Teamscale server.

  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.