Public | Automated Build

Last pushed: 10 months ago
Short Description
IRC bot for gitlab notifications, fork of chkelly/gitlab-irc.
Full Description



A lightweight gitlab irc bot that announces gitlab project notifications via webhooks.


  • Connecting to an IRC server over SSL
  • Authing with Nickserv
  • Support for announcing Commits, Merge Requests, Tags, and Issues.


  • Tested on Ruby 2.3.0
  • Tested with Gitlab CE 8.5


The following parameters can be set either in the config.yml file or via environment variables.

Option Example Value Description Required? Default
IRC_HOST IRC Server Hostname Yes
IRC_PORT 6667 IRC Server Port 6667
IRC_PASSWORD sample_password Server Password
SSL true if true, allows connection to irc server over ssl false
IRC_CHANNELS ['#dev','#all'] Array of channels to join Yes ['#gitlab-irc']
IRC_NICK GitLab Bot Name GitLab
IRC_REALNAME GitLabBot Real Name GitLabBot
IRC_USER_NAME gitlab-irc Username for authing with nickserv
IRC_USER_PASSWORD user_password Password for authing with nickserv
GITLAB_TOKEN sample_token Secret X-Gitlab-Token header used to authenticate requests
DEBUG true false



Start the gitlab-irc server with at least IRC_HOST and IRC_CHANNELS environment variables set:

docker run -e -e "IRC_CHANNELS=['#gitlab-irc']" -e IRC_NICK=gitlab-9875 -d -p 5000:5000 --restart=always --name gitlab-irc chkelly/gitlab-irc:v1.0.5

Configure Projects within Gitlab

Within Gitlab CE, select a project, then go to Settings -> Hooks, and enter in the below. Check all the boxes. Adjust the below host and port to point to the ip:port that the gitlab-irc service is running on.

Docker Pull Command
Source Repository