This module is an IRC transport that can be used to join channels on IRC servers.
End user information:
A XMPP client with ‘groupchat 1.0’ support or Multi-User Chat support ([
XEP-0045]) is necessary to join IRC channels.
An IRC channel can be joined in nearly the same way as joining a XMPP Multi-User Chat room. The difference is that the room name will be ‘channel%
irc.example.org’ in case
irc.example.orgis the IRC server hosting ‘channel’. And of course the host should point to the IRC transport instead of the Multi-User Chat service.
You can register your nickame by sending ‘IDENTIFY password’ to
Entering your password is possible by sending ‘LOGIN nick password’ to
The IRC transport provides Ad-Hoc Commands ([
XEP-0050]) to join a channel, and to set custom IRC username and encoding.
When using a popular XMPP server, it can occur that no connection can be achieved with some IRC servers because they limit the number of connections from one IP.
host: HostName: This option defines the Jabber ID of the service. If the
option is not specified, the Jabber ID will be the hostname of the
virtual host with the prefix ‘
irc.’. The keyword “@HOST@” is
replaced at start time with the real virtual host name.
db_type: mnesia|sql|riak: Define the type of storage where the module will create the tables and store user information. The default is the storage defined by the global option
mnesia if omitted. If
riak value is defined, make sure you have defined the database, see database.
access: AccessName: This option can be used to specify who may use the IRC transport
default_encoding: Encoding: Set the default IRC encoding. Default value:
In the first example, the IRC transport is available on (all) your virtual host(s) with the prefix ‘
irc.’. Furthermore, anyone is able to use the transport. The default encoding is set to “iso8859-15”.
modules: ... mod_irc: access: all default_encoding: "iso8859-15" ...
In next example the IRC transport is available with JIDs with prefix
irc-t.net. Moreover, the transport is only accessible to two users of
example.org, and any user of
acl: paying_customers: user: - "customer1": "example.org" - "customer2": "example.org" server: "example.com" access_rules: irc_users: - allow: paying_customers modules: ... mod_irc: access: irc_users host: "irc.example.net" ...