2 ngIRCd - Next Generation IRC Server
3 http://ngircd.barton.de/
5 (c)2001-2011 Alexander Barton and Contributors.
6 ngIRCd is free software and published under the
7 terms of the GNU General Public License.
12 ngIRCd doesn't implement a "special IRC services interface", but services
13 acting as a "regular servers" ("pseudo servers") are supported, either
14 using the IRC protocol as defined in RFC 1459 or RFC 2812.
16 Support for Services has been tested using
17 - Anope 1.9.8 or later (<http://www.anope.org/>; unreleased!)
18 - Atheme 7.0.2 or later (<http://www.atheme.net>)
19 - "IRC Services" 5.1.x by Andrew Church (<http://achurch.org/services/>)
21 This document describes setting up ngIRCd and these services.
23 Please let us know if you are successfully using other IRC service packages or
24 which problems you encounter -- thanks!
30 The "pseudo server" handling the IRC services is configured as a regular
31 remote server in the ngircd.conf(5). In addition the variable "ServiceMask"
32 should be set, enabling this ngIRCd to recognize the "pseudo users" as IRC
33 services instead of regular IRC users.
38 Name = services.irc.net
44 Setting up Anope 1.9.x
45 ~~~~~~~~~~~~~~~~~~~~~~
47 Anope 1.9.8 or later (<http://www.anope.org/>; unreleased as of 2012-11-10)
48 may be used with ngIRCd using the "ngircd" protocol module.
49 Until Anope 1.9.8 is released, you have to use the sources from the Anope
50 development GIT tree, see <http://sourceforge.net/projects/anope/develop/>!
52 At least the following settings have to be tweaked, in addition to all the
53 settings marked as required by Anope:
55 In conf/services.conf:
59 name = "services.host"
60 value = "services.irc.net"
65 host = "server.irc.net"
70 # Load ngIRCd protocol module
71 module { name = "ngircd" }
75 # Must be set to the "MaxNickLength" setting of ngIRCd!
81 In conf/nickserv.conf:
85 # not required if you are running ngIRCd with a higher nickname limit
86 # ("MaxNickLength") than 11 characters, but REQUIRED by default!
87 guestnickprefix = "G-"
91 Setting up Atheme 7.0.2 or later
92 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
94 Atheme 7.0.2 or later (<http://www.atheme.net>) may be used with ngIRCd using
95 the "ngircd" protocol module.
97 The following settings need to be in atheme.conf:
99 loadmodule "modules/protocol/ngircd";
101 uplink "server.irc.net" {
106 The documentation of Atheme can be found in the doc/ directory of the
107 Atheme source distribution.
110 Setting up IRC Services 5.1.x
111 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
113 IRC Services 5.1.3 and above can be used with ngIRCd using the "rfc1459"
116 Please note that versions up to and including 5.1.3 contain a bug that
117 sometimes causes IRC Services to hang on startup. There are two workarounds:
118 a) send the services process a HUP signal ("killall -HUP ircservices")
119 b) apply this patch to the IRC Services source tree:
120 <ftp://ngircd.barton.de/ngircd/contrib/IRCServices513-FlushBuffer.patch>
122 At least the following settings have to be tweaked, in addition to all the
123 settings marked as required by IRC Services:
127 Variable Example value
129 RemoteServer server.irc.net 6667 "123abc"
130 ServerName "services.irc.net"
131 LoadModule protocol/rfc1459
135 Module protocol/rfc1459
137 The documentation of IRC Services can be found here:
138 <http://www.ircservices.za.net/docs/>