GitLab Discord Webhook

A middleman between GitLab and Discord webhooks to show better formatted messages.

Use instructions

In order to use this, you must have a public IP address, with port 7400 open.

• Install modules in requirements.txt (Python 3.10 or higher)

python -m pip install -r requirements.txt

• Create a config.ini file, you can copy and rename config-example.ini.
• Create a discord webhook on the desired channel, and paste the URL in the webhook entry.
• Execute main.py
• Go to the desired GitLab project and go to Settings > Integrations
• Paste the public address of your instance
• Select the desired Triggers.
• Click Add Webhook.

From now on, changes to the project will be posted on the specified channel.
You can have multiple projects pointing to the same gitlab-discord-webhook instance,
but every instance will only post messages through a single Discord webhook.

Supported Triggers

• Push events
• Tag push events
• Comments
• Confidential Comments
• Issues events
• Confidential Issues events
• Merge request events
• Job events
• Pipeline events
• Wiki Page events

Running from Docker

The image can be pulled from Docker Hub:

docker pull galarzaa90/gitlab-discord-webhook:latest

Alternatively, the image can be built from the root of the project’s source.

docker build . -t gitlab-discord-webhook:local

To run the image:

docker run -p 7400:7400 --rm -ti gitlab-discord-webhook:local

References

• GitLab Webhooks Documentation
• Discord Webhooks Documentation