GitLab

Use GitLab integration to track GitLab issues directly within Zammad tickets. Add links to issues and get meta information like status (open/closed), assignee, labels and more.

Please note that our GitLab integration does not support merge requests.

Integration page for GitLab

Setup

  1. Create a new API token in GitLab. Zammad supports the usage of a group access token, a project access token and a personal access token.

  2. Add a name, set an expiration date and set the permission read_api.

  3. Enter your new API token in Zammad and enable the GitLab integration. Use the default API endpoint (https://gitlab.com/api/graphql) unless you’re a self-hosted GitLab user.

Hint

🔒 If you wish to link issues on any private repos…

Your API token must belong to an account with access to those repos.

Danger

Please be aware that turning off SSL verification is a security risk. It should only be used temporarily or for testing purposes. If turned off, there is no verification of the certificate, which means that any presented certificate will be accepted.

Once completed, a new GitLab issues tab will appear in the ticket pane. 🎉

Troubleshooting

Token verification is taking a long time

Slight delays are normal (<2 min.), especially for systems under heavy load.

Self-hosted administrators, please check your network settings to ensure that your Zammad server can reach gitlab.com.

I reloaded the page and now the API token is gone

This may indicate that Zammad is still verifying your API token. Try reloading the page again in a couple minutes.