> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.axolo.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# GitLab troubleshooting hub: webhooks, access tokens, CI/CD, and MR notifications

Use this guide as the starting point when Axolo does not behave as expected with GitLab.

It links the most common GitLab issues: missing merge request channels, webhook errors, access token problems, self-hosted setup, and CI/CD notifications.

## Start here: what is broken?

### Axolo does not create Slack channels for merge requests

Start with:

[Axolo is not opening channels](https://help.axolo.co/en/article/axolo-is-not-opening-channels-1x9wo9w/)

Common causes:

- the GitLab group/project is not connected to Axolo,
- the repository/project is inactive in Axolo,
- the MR author is not onboarded in Axolo,
- the MR was opened by a bot while bots are disabled,
- Axolo did not receive the GitLab event,
- the MR was explicitly excluded with `_noslackchannel`.

### GitLab messages are not sent to Slack

Read:

[GitHub or GitLab messages are not sent in Slack](https://help.axolo.co/en/article/github-or-gitlab-messages-are-not-sent-in-slack-1kz0mus/)

### Slack messages are not sent back to GitLab

Read:

[Slack messages are not sent to GitHub/GitLab](https://help.axolo.co/en/article/slack-messages-are-not-sent-to-githubgitlab-jirytg/)

### Pipeline or CI/CD notifications are missing

Read:

[Pipeline and CI/CD GitLab notifications troubleshooting](https://help.axolo.co/en/article/pipeline-and-cicd-gitlab-notifications-troubleshooting-wxwhy7/)

## GitLab Cloud installation

For GitLab Cloud, Axolo installation is similar to GitHub but less granular.

After installing the application, you select the GitLab group you want to integrate with Axolo. Axolo then saves your organization members and project information.

Required GitLab scopes are:

- `api`,
- `openid`,
- `profile`,
- `email`.

## GitLab self-hosted installation

For self-hosted GitLab, Axolo needs a GitLab application created in your GitLab instance.

The Axolo GitLab app should use these redirect URIs:

- `https://api.axolo.co/redirect/gitlab`
- `https://api.axolo.co/player/auth/gitlab/callback`

Required scopes are:

- `api`,
- `read_user`,
- `openid`,
- `profile`,
- `email`.

The GitLab application must be confidential.

If your self-hosted instance is behind a VPN or firewall, contact us so we can share the Axolo server IPs to allowlist.

Read:

[GitLab self-hosted installation](https://axolo.co/docs/gettingstarted/installation-gitlab-self-hosted)

## GitLab webhooks

Axolo needs GitLab events to receive merge request, comment, and pipeline activity.

If webhooks are failing, read:

[Troubleshooting: GitLab Webhook Issues](https://help.axolo.co/en/article/troubleshooting-gitlab-webhook-issues-106a3a6/)

If GitLab shows a webhook error, include the error when contacting support.

## GitLab access tokens

If your GitLab token is missing, expired, revoked, or lacks permission, Axolo may fail to update webhooks or synchronize data.

Read:

[Enable Access Tokens for GitLab](https://help.axolo.co/en/article/enable-access-tokens-for-gitlab-3fgxcl/)

## GitLab CODEOWNERS and auto reviewer assignment

Axolo has a GitLab auto reviewer assignment feature that can use your GitLab `CODEOWNERS` file to select reviewers for merge requests.

Read:

[Auto Reviewer Assignment for GitLab by Axolo](https://axolo.co/docs/gitlab/auto-assignement-for-reviewers)

## Common GitLab symptoms

### New MRs do not appear in Slack

Check:

1. The MR belongs to the GitLab group/project connected to Axolo.
2. The repository/project is active in Axolo.
3. The MR author is onboarded in Axolo.
4. The MR was not opened by a disabled bot or service account.
5. The MR does not include `_noslackchannel` in the body or label.
6. Axolo receives GitLab events for this group/project.

### Pipeline notifications do not appear

Check:

1. The MR channel exists.
2. GitLab sends pipeline events to Axolo.
3. The pipeline is linked to the merge request.
4. Pipeline/CI-CD notifications are enabled for your setup.

Then read:

[Pipeline and CI/CD GitLab notifications troubleshooting](https://help.axolo.co/en/article/pipeline-and-cicd-gitlab-notifications-troubleshooting-wxwhy7/)

## What to send support

For GitLab troubleshooting, send:

- GitLab group or project path,
- example MR link,
- whether the issue affects all projects or one project,
- whether your GitLab is cloud or self-hosted,
- screenshot or text of webhook errors,
- whether the MR was created by a human, bot, or service account,
- whether the repository/project is active in Axolo.