GitLab provides a way to push update messages to an irker server. When configured, pushes to a project trigger the service to send data directly to the irker server.
See also the irker integration API documentation.
For more information, see the irker project homepage.
You need to set up an irker daemon. To do so:
Download the irker code from its repository:
git clone https://gitlab.com/esr/irker.git
Run the Python script named
irkerd. This is the gateway script. It acts both as an IRC client, for sending messages to an IRC server, and as a TCP server, for receiving messages from the GitLab service.
If the irker server runs on the same machine, you are done. If not, you need to follow the first steps of the next section.
- On the top bar, select Menu > Projects and find the project you want to configure for notifications.
- Navigate to the Integrations page.
- Select irker (IRC gateway).
- Ensure that the Active toggle is enabled.
- Optional. Under Server host, enter the server host address where
irkerdruns. If empty, it defaults to
- Optional. Under Server port, enter the server port of
irkerd. If empty, it defaults to
- Optional. Under Default IRC URI, enter the default IRC URI, in the format
irc[s]://domain.name. It’s prepended to every channel or user provided under Recipients, which is not a full URI.
- Under Recipients, enter the users or channels to receive updates, separated by spaces
#channel1 user1). For more details, see Enter irker recipients.
- Optional. Under Colorize messages, select the checkbox. irker will highlight your messages.
- Select Save changes or optionally select Test Settings.
If you left the Default IRC URI field empty, enter recipients as a full URI:
irc[s]://irc.network.net[:port]/#channel. If you entered a default IRC URI there, you can use just
channel or user names.
To send messages:
- To a channel (for example,
#chan), irker accepts channel names of the form
- To a password-protected channel, append
?key=thesecretpasswordto the channel name, with the channel password instead of
thesecretpassword. For example,
chan?key=hunter2. Do not put the
#sign in front of the channel name. If you do, irker tries to join a channel named
#chan?key=passwordand so it can leak the channel password through the
/whoisIRC command. This is due to a long-standing irker bug.
- In a user query, add
,isnickafter the user name. For example,