Configure with GitLab

Integrate Baz with GitLab repos to mirror your team's codebase and review changes.

Baz for GitLab is currently in Beta. For access click here.

Configure with GitLab

Integrate Baz with GitLab repositories to mirror your codebase and enable Baz’s review capabilities. After signing in to Baz (via GitHub or GitLab), navigate to your workspace and select Connect to GitLab. This will prompt you to provide GitLab access credentials and choose which projects to integrate with Baz.

Note: If an administrator has already configured a GitLab integration for your organization, simply login to Baz using GitLab to configure relevant projects.

Provide a GitLab Personal Access Token

When connecting Baz to GitLab, you’ll be asked to enter a GitLab Personal Access Token (PAT). This token allows Baz to call the GitLab API on behalf of the PAT owner.

To generate a PAT, go to your GitLab account’s Settings > Access Tokens. We recommend creating a new user as a service account, associating this user to the group you’d like to install Baz on, and providing it with the personal access token to allow access.

Before proceeding, ensure the service account created has the developer permissions.

Once you have the PAT, enter it in Baz’s Connect to GitLab. Baz will securely store the token and verify it. By default Baz connects to gitlab.com, if you self-host GitLab change it to your custom domain.

Also, if you are self hosting, please allow our three public IP addresses: 18.190.165.140, 3.20.124.148, 3.12.220.91 .

After submitting the token, you’ll see a confirmation message indicating that Baz is connected.

Select GitLab Projects to Integrate

After connecting with your PAT, Baz will retrieve the list of GitLab projects that it has access to. You’ll see this list in Baz’s interface, where you can choose which repositories to integrate.

Select the ones you want Baz to review. Once confirmed, Baz will sync the chosen repositories into your Baz workspace. This includes cloning the repositories, indexing their code, and synchronizing GitLab groups and members associated with those projects.

From here, your Baz workspace mirrors your GitLab projects. In the Agents section, you’ll see which Reviewers are active in your projects. In the Changes section, you can access merge requests from projects, ready for review.

Performing Reviews (Comments & Merges)

Once integrated, Baz can help review code changes from your GitLab projects. Comments or merge actions performed in Baz will appear directly on GitLab merge requests, authored by the account tied to the PAT.

Update the GitLab Integration

You can reconfigure the GitLab integration at any time from Settings > Integrations.

• Add/Remove Projects: Open the project list again and adjust which repositories are synced. Baz will add any newly selected repositories or stop syncing deselected ones.

• Update Credentials: To update credentials, create a new integration.

FAQ

Does Baz support GitLab out of the box?

Yes. Baz provides instructions on integrating with GitLab so that merge requests are automatically reviewed by Baz.

What permissions are necessary for GitLab integration?

Baz needs read access to code and merge request metadata, and permission to post comments in the MR discussion.

Are there limitations or feature parity differences between GitHub vs GitLab integration?

There may be slight differences (e.g. event triggers, comment threading) that impact agent responsiveness but overall both integrations are identical.