# Enable GitLab Integration

## Get Started

The Nx Cloud GitLab Integration lets you access the result of every run—with all its logs and build insights—straight from your Merge Requests.

## Connecting Your Workspace

![Access VCS Setup](/nx-cloud/set-up/access-vcs-setup.png)

Once on the VCS Integrations setup page, select "GitLab" in the platforms dropdown. You will be prompted to enter the name of your repository.

![Add GitLab Repository](/nx-cloud/set-up/add-gitlab-repository.png)

### Configuring Authentication

#### Using a Personal Access Token

To use a Personal Access Token for authentication, one must be generated with proper permissions. The minimum required permissions are shown in the screenshot below.

![Minimum GitLab Personal Access Token Permissions](/nx-cloud/set-up/minimal-gitlab-access-token.png)

Once this token is created, select the radio button for providing a personal access token, paste the value, and then click "Test Connection".

![Use PAT for Authentication](/nx-cloud/set-up/use-gitlab-pat-auth.png)

This will verify that Nx Cloud can connect to your repo. Upon a successful test, your configuration is saved, and setup is complete.

### Advanced Configuration

If your company runs a self-hosted GitLab installation, you may need to override the default URL that Nx Cloud uses to connect to the GitLab API. To do so, check the box labeled "Override GitLab API URL" and enter the correct URL for your organization.

![Override GitLab API URL](/nx-cloud/set-up/override-gitlab-api-url.png)
