1 ########################################################################
3 # ___ ___ ____ ____ _ #
4 # |_ _|_ __ ___ _ __|_ _| _ \ / ___|__| | #
5 # | || '_ \/ __| '_ \| || |_) | | / _` | #
6 # | || | | \__ \ |_) | || _ <| |__| (_| | #
7 # |___|_| |_|___/ .__/___|_| \_\\____\__,_| #
10 # / ___|___ _ __ / _(_) __ _ _ _ _ __ __ _| |_(_) ___ _ __ #
11 # | | / _ \| '_ \| |_| |/ _` | | | | '__/ _` | __| |/ _ \| '_ \ #
12 # | |__| (_) | | | | _| | (_| | |_| | | | (_| | |_| | (_) | | | | #
13 # \____\___/|_| |_|_| |_|\__, |\__,_|_| \__,_|\__|_|\___/|_| |_| #
16 ##################################||####################################
18 ##################################||####################################
20 # This is an example of the config file for InspIRCd. #
21 # Change the options to suit your network #
25 # If you would like more detailed options, but a slightly more #
26 # painful configuration, please see inspircd.conf.example.old #
28 # ____ _ _____ _ _ ____ _ _ _ #
29 # | _ \ ___ __ _ __| | |_ _| |__ (_)___ | __ )(_) |_| | #
30 # | |_) / _ \/ _` |/ _` | | | | '_ \| / __| | _ \| | __| | #
31 # | _ < __/ (_| | (_| | | | | | | | \__ \ | |_) | | |_|_| #
32 # |_| \_\___|\__,_|\__,_| |_| |_| |_|_|___/ |____/|_|\__(_) #
34 # Lines prefixed with READ THIS BIT, as shown above, are IMPORTANT #
35 # lines, and you REALLY SHOULD READ THEM. Yes, THIS MEANS YOU. Even #
36 # if you've configured InspIRCd before, these probably indicate #
37 # something new or different to this version and you SHOULD READ IT. #
39 ########################################################################
41 # Unalphabeticalise the modules list at your own risk #
43 ########################################################################
45 #-#-#-#-#-#-#-#-#-# INCLUDE CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#-#-#
47 # This optional tag allows you to include another config file #
48 # allowing you to keep your configuration tidy. The configuration #
49 # file you include will be treated as part of the configuration file #
50 # which includes it, in simple terms the inclusion is transparent. #
52 # All paths to config files are relative to the directory of the main #
53 # config file inspircd.conf, unless the filename starts with a forward#
54 # slash (/) in which case it is treated as an absolute path. #
56 # You may also include an executable file, in which case if you do so #
57 # the output of the executable on the standard output will be added #
58 # to your config at the point of the include tag. #
60 # Syntax is as follows: #
61 #<include file="file.conf"> #
62 #<include executable="/path/to/executable parameters"> #
66 #-#-#-#-#-#-#-#-#-#-#-#- SERVER DESCRIPTION -#-#-#-#-#-#-#-#-#-#-#-#-
68 # Here is where you enter the information about your server. #
72 # name: Hostname of your server. Does not need to be valid.
73 name="penguin.omega.org.za"
75 # description: Server description. Spaces are allowed.
76 description="Waddle World"
78 # network: Network name given on connect to clients.
79 # Should be the same on all servers on the network and
84 #-#-#-#-#-#-#-#-#-#-#-#- ADMIN INFORMATION -#-#-#-#-#-#-#-#-#-#-#-#
86 # Describes the Server Administrator's real name (optionally), #
87 # nick, and email address. #
89 # Syntax is as follows: #
90 # <admin name="real name" #
92 # email="email@address.com"> #
95 <admin name="Johnny English"
97 email="MI5@the.best.secret.agent">
100 #-#-#-#-#-#-#-#-#-#-#-#- PORT CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-
102 # Enter the port and address bindings here. #
104 # bind address - Specifies which address ports bind to. Leaving this #
105 # field blank binds the port to all IP's available. #
107 # port - The port number to bind to. You may specify a port #
108 # range here, e.g. "6667-6669,7000,7001". If you do #
109 # this, the server will count each port within your #
110 # range as a separate binding, making the above #
111 # example equivalent to five separate bind tags. #
112 # A failure on one port in the range does not prevent #
113 # the entire range from being bound, just that one #
116 # type - Can be 'clients' or 'servers'. The clients type is #
117 # a standard TCP based socket, the servers type is a #
118 # also a TCP based connection but of a different #
119 # format. SSL support is provided by modules, to #
120 # enable SSL support, please read the module section #
121 # of this configuration file. #
123 # ssl - When using m_ssl_gnutls.so or m_ssl_openssl.so #
124 # modules, you must define this value to use ssl on #
125 # that port. Valid values are 'gnutls' or 'openssl' #
126 # respectively. If the module is not loaded, this #
127 # setting is ignored. #
129 # transport - If you have m_spanningtree.so loaded, along with #
130 # either one of the SSL modules (m_ssl_gnutls or #
131 # m_ssl_openssl) or m_ziplinks.so, then you may make #
132 # use of this value. #
133 # Setting it to 'openssl' or 'gnutls' or 'zip' #
134 # indicates that the port should accept connections #
135 # using the given transport name. Transports are #
136 # layers which sit on top of a socket and change the #
137 # way data is sent and received, e.g. encryption, #
138 # compression, and other such things. Because this #
139 # may not be limited in use to just encryption, #
140 # the 'ssl' value used for client ports does not #
141 # exist for servers, and this value is used instead. #
142 # ____ _ _____ _ _ ____ _ _ _ #
143 # | _ \ ___ __ _ __| | |_ _| |__ (_)___ | __ )(_) |_| | #
144 # | |_) / _ \/ _` |/ _` | | | | '_ \| / __| | _ \| | __| | #
145 # | _ < __/ (_| | (_| | | | | | | | \__ \ | |_) | | |_|_| #
146 # |_| \_\___|\__,_|\__,_| |_| |_| |_|_|___/ |____/|_|\__(_) #
148 # If you want to link servers to InspIRCd you must load the #
149 # m_spanningtree.so module! Please see the modules list below for #
150 # information on how to load this module! If you do not load this #
151 # module, server ports will NOT be bound! #
153 # Leaving address empty binds to all available interfaces #
155 # Syntax is as follows: #
157 # <bind address="ip address" port="port" type="clients"> #
158 # <bind address="ip address" port="port" type="servers"> #
160 # If InspIRCd is built for IPv6, and you wish to accept IPv4 clients, #
161 # then you can specify IPv4 ip addresses here to bind. You may also #
162 # use the 4in6 notation, ::ffff:1.2.3.4, where 1.2.3.4 is the IPv4 #
163 # address to bind the port, but as of InspIRCd 1.1.1, this is not #
166 # ------------------------------------------------------------------- #
168 # PLEASE NOTE: If you have build InspIRCd as an IPv6 server, and you #
169 # specify an empty bind address, the binding will be bound to ALL THE #
170 # IPv6 IP ADDRESSES, and not the IPv4 addresses. If you are using an #
171 # IPv6 enabled InspIRCd and want to bind to multiple IPv4 addresses #
172 # in this way, you must specify them by hand. If you have built the #
173 # server for IPv4 connections only, then specifying an empty bind #
174 # address binds the port to all IPv4 IP addresses, as expected. #
177 <bind address="" port="6000" type="clients">
178 <bind address="" port="6660-6669" type="clients" ssl="gnutls">
180 # When linking servers, the openssl and gnutls transports are largely
181 # link-compatible and can be used alongside each other or either/or
182 # on each end of the link without any significant issues.
184 <bind address="" port="7000,7001" type="servers">
185 <bind address="1.2.3.4" port="7005" type="servers" transport="openssl">
188 #-#-#-#-#-#-#-#-#-#- DIE/RESTART CONFIGURATION -#-#-#-#-#-#-#-#-#-#-
190 # You can configure the passwords here which you wish to use for #
191 # the die and restart commands. Only trusted IRCop's who will #
192 # need this ability should know the die and restart password. #
194 # Syntax is as follows: #
195 # <power diepass="die password" restartpass="restart password" #
196 # pause="secs before dying"> #
199 <power diepass="" restartpass="" pause="2">
202 #-#-#-#-#-#-#-#-#-#- CONNECTIONS CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#
204 # This is where you can configure which connections are allowed #
205 # and denied access onto your server. The password is optional. #
206 # You may have as many of these as you require. To allow/deny all #
207 # connections, use a '*' or 0.0.0.0/0. #
209 # Syntax is as follows: #
211 # <connect name="myallow" allow="1.2.3.0/24" limit="5" #
212 # password="blahblah" timeout="10" timeout="blah" #
213 # flood="5" threshold="8" pingfreq="120" sendq="99999" #
214 # revcq="696969" localmax="3" globalmax="3" #
215 # port="6660" maxchans="50" limit="999"> #
217 # <connect name="blocked" deny="127.0.0.1" port="6667"> #
219 # <connect name="something" parent="myallow" pingfreq="60"> #
221 # IP masks may be specified in CIDR format or wildcard format, #
222 # for IPv4 and IPv6. You *cannot* use hostnames in the allow or #
223 # deny field, as the state is applied before the user's DNS has #
226 # You can optionally name your connect allow/deny tags. If you do #
227 # this, you may reference this connect tag as the parent of another #
228 # connect tag with the <connect:parent> option as shown above. If #
229 # you do this, any options not explicitly specified in the tag will #
230 # be copied from the parent. #
232 # If the value maxchans is included, this overrides all other max #
233 # channels related settings, including the separate oper maximum. #
234 # You may set this to any (sane) value you wish and it applies to #
235 # all users within this connect tag. #
237 # You may optionally include timeout="x" on any allow line, which #
238 # specifies the amount of time given before an unknown connection #
239 # is closed if USER/NICK/PASS are not given. This value is in secs. #
241 # You may optionally limit the number of clients that are matched #
242 # by a single <connect> tag by specifying the maximum in the limit #
243 # parameter. If set to 0, there is no limit, which is the default. #
245 # You should also include a flood="x" line which indicates #
246 # the number of lines a user may place into their buffer at once #
247 # before they are disconnected for excess flood. This feature can #
248 # not be disabled, however it can be set to extremely high values, #
249 # rendering it effectively disabled. A recommended value is 10. #
250 # A counter is maintained for each user which is reset every #
251 # 'threshold' seconds and specifying this threshold value with #
252 # threshold="X" indicates how often the counter is reset. For #
253 # example, with flood="5" and threshold="8", the user may not send #
254 # more than 5 lines in 8 secs. #
256 # You may optionally specify the sendq size and ping frequency of #
257 # each connect:allow line using the pingfreq="X" and sendq="X" #
258 # settings as shown in the full example below. #
259 # The ping frequency is specified in seconds, and the sendq size #
260 # in bytes. It is recommended, although not enforced, that you #
261 # should never set your sendq size to less than 8K. Send Queues are #
262 # dynamically allocated and can grow as needed up to the maximum #
265 # The optional recvq value is the maximum size which users in this #
266 # group may grow their receive queue to. This is recommended to be #
267 # kept pretty low compared to the sendq, as users will always #
268 # receive more than they send in normal circumstances. The default #
269 # if not specified is 4096. #
271 # The sendq is the data waiting to be sent TO THE USER. #
272 # The recvq is the data being received FROM THE USER. #
273 # The names sendq and recvq are from the SERVER'S PERSPECTIVE not #
274 # that of the user... Just to clear up any confusion or complaints #
275 # that these are backwards :p #
277 # The localmax and globalmax values can be used to enforce local #
278 # and global session limits on connections. The session limits are #
279 # counted against all users, but applied only to users within the #
280 # class. For example, if you had a class 'A' which has a session #
281 # limit of 3, and a class 'B' which has a session limit of 5, and #
282 # somehow, two users managed to get into class B which also match #
283 # class A, there is only one connection left for this IP now in A, #
284 # but if they can connect again to B, there are three. You get the #
287 # NOTE NOTE NOTE NOTE NOTE NOTE! #
288 # The maximum limits by default apply to individual IP addresses #
289 # This *MAY* be changed by modifying the <cidr> block, in order #
290 # to detect cloning across an ISP. #
292 # The optional port value determines which port the connect tag is #
293 # handling. If left out the connect tag covers all bound ports else #
294 # only incoming connections on the specified port will match. Port #
295 # tags may be used on connect allow and connect deny tags. #
297 # The limit value determines the maximum number of users which may #
298 # be in this class. Combine this with CIDR masks for various ISP #
299 # subnets to limit the number of users which may connect at any one #
300 # time from a certain ISP. Omit this value to not limit the tag. #
303 <connect allow="196.12.*" password="secret" port="6667">
316 <connect deny="69.254.*">
317 <connect deny="3ffe::0/32">
319 #-#-#-#-#-#-#-#-#-#-#-#- CIDR CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-
321 # CIDR configuration allows detection of clones and applying of #
322 # throttle limits across a CIDR range. (A CIDR range is a group of #
323 # IPs, for example, the CIDR range 192.168.1.0-192.168.1.255 may be #
324 # represented as 192.168.1.0/24). This means that abuse across an ISP #
325 # is detected and curtailed much easier. #
328 # This specifies how many bits of an IP address should be checked #
329 # against cloning in the <connect> tags, for example, if <connect> #
330 # tags specified a limit of 2 (low!), and three users attempted to #
331 # connect in the IP range 192.168.1.0-192.168.1.255, and ipv4clone #
332 # was set to '24', the third connection would be disconnected. #
334 # Valid values are 0-32, but you *don't* want 0. Using values which #
335 # are not multiples of 8 can give confusing behaviour. #
336 # For more info, see: http://www.inspircd.org/wiki/CIDR_Tutorial #
338 # ipv6clone works in the same way, except for ipv6 addresses. Valid #
339 # range is 0-128, but you *don't* want anything too small. #
341 # Setting these to their maximum value (32, 128) will result in #
342 # no actual CIDR checking being done, and clone checking will only be #
343 # done across individual IPs. This is the default behaviour. #
349 # This file has all the information about oper classes, types and o:lines.
350 # You *MUST* edit it.
351 <include file="opers.conf.example">
353 # This file has all the information about server links and ulined servers.
354 # You *MUST* edit it if you intend to link servers.
355 <include file="links.conf.example">
357 #-#-#-#-#-#-#-#-#-#- MISCELLANEOUS CONFIGURATION -#-#-#-#-#-#-#-#-#-#
359 # These options let you define the path to your motd and rules #
360 # files. If these are relative paths, they are relative to the #
361 # configuration directory. #
364 <files motd="inspircd.motd.example"
365 rules="inspircd.rules.example">
367 #-#-#-#-#-#-#-#-#-#-#-# MAXIMUM CHANNELS -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
369 # This optional configuration tag lets you define the maximum number #
370 # of channels that both opers and users may be on at any one time. #
371 # The default is 20 for users and 60 for opers if this tag is not #
372 # defined. Remote users are not restricted in any manner. #
378 #-#-#-#-#-#-#-#-#-#-#-#-#-#-# DNS SERVER -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
380 # Define your DNS server address here. InspIRCd has its own resolver. #
381 # If you do not define this value, then InspIRCd will attempt to #
382 # determine your DNS server from your operating system. On POSIX #
383 # platforms, InspIRCd will read /etc/resolv.conf, and populate this #
384 # value with the first DNS server address found. On Windows platforms #
385 # InspIRCd will check the registry, and use the DNS server of the #
386 # first active network interface, if one exists. #
387 # If a DNS server cannot be determined from these checks, the default #
388 # value '127.0.0.1' is used instead. The timeout value is in seconds. #
390 # ____ _ _____ _ _ ____ _ _ _ #
391 # | _ \ ___ __ _ __| | |_ _| |__ (_)___ | __ )(_) |_| | #
392 # | |_) / _ \/ _` |/ _` | | | | '_ \| / __| | _ \| | __| | #
393 # | _ < __/ (_| | (_| | | | | | | | \__ \ | |_) | | |_|_| #
394 # |_| \_\___|\__,_|\__,_| |_| |_| |_|_|___/ |____/|_|\__(_) #
396 # When choosing a server, be sure to choose one which will do a #
397 # RECURSIVE LOOKUP. InspIRCd's resolver does not currently do these #
398 # recursive lookups itself, to save time and resources. The DNS #
399 # server recommended by the InspIRCd team is bind, available from the #
400 # ISC website. If your DNS server does not do a recursive lookup, you #
401 # will be able to notice this by the fact that none of your users are #
402 # resolving even though the DNS server appears to be up! Most ISP and #
403 # hosting provider DNS servers support recursive lookups. #
405 # ------------------------------------------------------------------- #
407 # NOTE: If you have built InspIRCd with IPv6 support, then both #
408 # IPv6 and IPv4 addresses are allowed here, and also in the system #
409 # resolv.conf file. Remember that an IPv4 DNS server can still #
410 # resolve IPv6 addresses, and vice versa. #
413 <dns server="127.0.0.1" timeout="5">
415 # An example of using an IPv6 nameserver
416 #<dns server="::1" timeout="5">
418 #-#-#-#-#-#-#-#-#-#-#-#-#-#-# PID FILE -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
420 # Define the path to the PID file here. The PID file can be used to #
421 # rehash the ircd from the shell or to terminate the ircd from the #
422 # shell using shell scripts, perl scripts, etc... and to monitor the #
423 # ircd's state via cron jobs. If this is a relative path, it will be #
424 # relative to the configuration directory, and if it is not defined, #
425 # the default of 'inspircd.pid' is used. #
428 #<pid file="/path/to/inspircd.pid">
430 #-#-#-#-#-#-#-#-#-#-#-#-#- BANLIST LIMITS #-#-#-#-#-#-#-#-#-#-#-#-#-#-#
432 # Use these tags to customise the ban limits on a per channel basis. #
433 # The tags are read from top to bottom, and any tag found which #
434 # matches the channels name applies the banlimit to that channel. #
435 # It is advisable to put an entry with the channel as '*' at the #
436 # bottom of the list. If none are specified or no maxbans tag is #
437 # matched, the banlist size defaults to 64 entries. #
440 <banlist chan="#morons" limit="128">
441 <banlist chan="*" limit="69">
443 #-#-#-#-#-#-#-#-#-#-#- DISABLED FEATURES -#-#-#-#-#-#-#-#-#-#-#-#-#-#
445 # This tag is optional, and specifies one or more features which are #
446 # not available to non-operators. #
448 # For example you may wish to disable NICK and prevent non-opers from #
449 # changing their nicknames. #
450 # Note that any disabled commands take effect only after the user has #
451 # 'registered' (e.g. after the initial USER/NICK/PASS on connection) #
452 # so for example disabling NICK will not cripple your network. #
454 # `fakenonexistant' will make the ircd pretend that nonexistant #
455 # commands simply don't exist to non-opers ("no such command"). #
457 #<disabled commands="TOPIC MODE" usermodes="" chanmodes="" fakenonexistant="yes">
460 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#- RTFM LINE -#-#-#-#-#-#-#-#-#-#-#-#-#-#
462 # Just remove this... Its here to make you read ALL of the config #
465 <die value="You should probably edit your config *PROPERLY* and try again.">
469 #-#-#-#-#-#-#-#-#-#-#-#-#- SERVER OPTIONS -#-#-#-#-#-#-#-#-#-#-#-#-#
471 # Settings to define which features are usable on your server. #
473 # prefixquit - A prefix to be placed on the start of a client's #
476 # suffixquit - A suffix to be placed on the end of a client's #
479 # fixedquit - A fixed quit message to display for all client #
480 # QUITS. If specified, overrides both prefixquit #
481 # and suffixquit options. #
483 # prefixpart - A prefix to be placed on the start of a client's #
486 # suffixpart - A suffix to be placed on the end of a client's #
489 # fixedpart - A fixed part message to display for all client #
490 # parts. If specified, overrides both prefixpart #
491 # and suffixpart options. #
493 # allowhalfop - Allows the +h channel mode #
495 # noservices - If noservices is true, yes, or 1, then the first #
496 # user into a channel gets founder status. This is #
497 # only useful on networks running the m_chanprotect #
498 # module without services. #
500 # qprefix - qprefix is used by the chanprotect module to give #
501 # a visible prefix to users set +q (founder) in chan #
502 # It should be set to something sensible like ~ or ! #
503 # If not set, no prefix is applied to users with +q #
505 # aprefix - aprefix is the same as qprefix, except it is for #
506 # giving users with mode +a (protected) a prefix #
508 # deprotectself - If this value is set to yes, true, or 1, then any #
509 # user with +q or +a may remove the +q or +a from #
510 # themselves. The default setting is to not enable #
511 # this feature, which stops even the founder taking #
512 # away their founder status without using services. #
514 # deprotectothers-If this value is set to yes, true, or 1, then any #
515 # user with +q or +a may remove the +q or +a from #
516 # other users. The default setting is to not enable #
517 # this feature, so that only +q may remove +a, and #
518 # nothing but services may remove +q. #
520 # cyclehosts - If this is set to true, yes or 1, then when a #
521 # user's hostname changes, they will appear to quit #
522 # and then rejoin with their new host. This prevents #
523 # clients from being confused by host changes, #
524 # especially in the case of bots, and it is #
525 # recommended that this option is enabled. #
527 # moduledir - This optional value indicates a runtime change of #
528 # the location where modules are to be found. This #
529 # does not add a supplementary directory. There can #
530 # only be one module path. #
532 # syntaxhints - If set to yes, true or 1, when a user does not #
533 # give enough parameters for a command, a syntax #
534 # hint will be given (using the RPL_TEXT numeric) #
535 # as well as the standard ERR_NEEDMOREPARAMS. #
537 # announcets - If this value is defined to yes, true, or 1, then #
538 # a channels' timestamp is updated, the users on #
539 # the channel will be informed of the change via #
540 # a server notice to the channel with the old and #
541 # new TS values in the timestamp. If you think this #
542 # is just pointless noise, define the value to 0. #
544 # ircumsgprefix - Use undernet style message prefix for channel #
545 # NOTICE and PRIVMSG adding the prefix to the line #
546 # of text sent out. Eg. NOTICE @#test :@ testing #
547 # vs. the off setting: NOTICE @#test :testing #
549 # hostintopic - If this is set to yes (the default) then the full #
550 # nick!user@host is shown for who set a TOPIC last. #
551 # if set to no, then only the nickname is shown. #
553 # serverpingfreq- This value, when set, allows you to change the #
554 # frequency of server to server PING messages. This #
555 # can help if you are having certain network issues. #
557 # pingwarning - This should be set to a number between 1 and 59 if #
558 # defined, and if it is defined will cause the server#
559 # to send out a warning via snomask +l if a server #
560 # does not answer to PING after this many seconds. #
561 # This can be useful for finding servers which are #
562 # at risk of pinging out due to network issues. #
564 # defaultmodes - The default modes to be given to each channel on #
565 # creation. Defaults to 'nt'. There should be no + #
566 # or - symbols in this sequence, if you add them #
567 # they will be ignored. You may add parameters for #
568 # modes which take them. #
570 # moronbanner - The NOTICE to show to users who are glined, zlined #
571 # klined or qlined when they are disconnected. This #
572 # is totally freeform, you may place any text here #
575 # exemptchanops - This option allows channel operators to be exempted#
576 # from certain channel modes. #
577 # Supported modes are +SfFgNc. Defaults to off. #
579 # invitebypassmodes - This option allows /invite to bypass modes #
584 <options prefixquit="Quit: "
602 moronbanner="You're banned! Email haha@abuse.com with the ERROR line below for help."
604 invitebypassmodes="yes">
607 #-#-#-#-#-#-#-#-#-#-#-# PERFORMANCE CONFIGURATION #-#-#-#-#-#-#-#-#-#-#
609 # maxwho - The maximum number of results returned by a /WHO #
610 # query. This is to prevent /WHO being used as a #
611 # spam vector or means of flooding an ircd. The #
612 # default is 128, it is not recommended to raise it #
613 # above 1024. Values up to 65535 are permitted. If #
614 # this value is omitted, any size WHO is allowed by #
617 # somaxconn - The maximum number of sockets that may be waiting #
618 # in the accept queue. This usually allows the ircd #
619 # to soak up more connections in a shorter space of #
620 # time when increased but please be aware there is a #
621 # system defined maximum value to this, the same way #
622 # there is a system defined maximum number of file #
623 # descriptors. Some systems may only allow this to #
624 # be up to 5 (ugh) while others such as FreeBSD will #
625 # default to a much nicer 128. #
627 # softlimit - This optional feature allows a defined softlimit. #
628 # if defined sets a soft maxconnections value, has #
629 # to be less than the ./configure maxclients #
631 # nouserdns - If set to yes, true or 1, no user DNS lookups #
632 # will be performed for connecting users. This can #
633 # save a lot of resources on very busy IRC servers. #
635 # quietbursts - When synching or splitting from the network, a #
636 # server can generate a lot of connect and quit #
637 # snotices to the +C and +Q snomasks. Setting this #
638 # value to yes squelches those messages, which can #
639 # make them more useful for opers, however it will #
640 # degrade their use by certain third party programs #
641 # such as BOPM which rely on them to scan users when #
642 # a split heals in certain configurations. #
644 # netbuffersize - Size of the buffer used to receive data from #
645 # clients. The ircd may only read() this amount #
646 # of text in one go at any time. (OPTIONAL) #
649 <performance netbuffersize="10240"
656 #-#-#-#-#-#-#-#-#-#-#-# SECURITY CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#
659 # - If this option is set, then invites are announced #
660 # to the channel when a user invites another user. #
661 # If you consider this to be unnecessary noise, #
662 # set this to 'none'. To announce to all ops, set #
663 # this to 'ops' and to announce to all users set the #
666 # The value 'dynamic' varies between 'ops' and 'all' #
667 # settings depending on if the channel is +i or not. #
668 # When the channel is +i, messages go only to ops, #
669 # and when the channel is not +i, messages go to #
670 # everyone. In short, the messages will go to every #
671 # user who has power of INVITE on the channel. This #
672 # is the recommended setting. #
674 # disablehmac - If you are linking your InspIRCd to older versions #
675 # then you can specify this option and set it to #
676 # yes. 1.1.6 and above support HMAC and challenge- #
677 # response for password authentication. These can #
678 # greatly enhance security of your server to server #
679 # connections when you are not using SSL (as is the #
680 # case with a lot of larger networks). Linking to #
681 # older versions of InspIRCd should not *usually* be #
682 # a problem, but if you have problems with HMAC #
683 # authentication, this option can be used to turn it #
686 # hidemodes - If this option is enabled, then the listmodes #
687 # given (e.g. +eI), will be hidden from users below #
688 # halfop. This is not recommended to be set on mode #
689 # +b, as it may break some features in popular #
690 # clients such as mIRC. #
692 # hidesplits - When set to 'yes', will hide split server names #
693 # from non-opers. Non-opers will see '*.net *.split' #
694 # instead of the server names in the quit message, #
695 # identical to the way IRCu displays them. #
697 # hidebans - When set to 'yes', will hide gline, kline, zline #
698 # and qline quit messages from non-opers. For #
699 # example, user A who is not an oper will just see #
700 # (G-Lined) while user B who is an oper will see the #
701 # text (G-Lined: Reason here) instead. #
703 # hidewhois - When defined with a non-empty value, the given #
704 # text will be used in place of the user's server #
705 # in WHOIS, when a user is WHOISed by a non-oper. #
706 # For example, most nets will want to set this to #
707 # something like '*.netname.net' to conceal the #
708 # actual server the user is on. #
710 # flatlinks - When you are using m_spanningtree.so, and this #
711 # value is set to yes, true or 1, /MAP and /LINKS #
712 # will be flattened when shown to a non-opers. #
714 # hideulines - When you are using m_spanningtree.so, and this #
715 # value is set to yes, true or 1, then U-lined #
716 # servers will be hidden in /LINKS and /MAP for non #
717 # opers. Please be aware that this will also hide #
718 # any leaf servers of a U-lined server, e.g. jupes. #
720 # userstats - The userstats field is optional and specifies #
721 # which stats characters in /STATS may be requested #
722 # by non-operators. Stats characters in this field #
723 # are case sensitive and are allowed to users #
724 # independent of if they are in a module or the core #
726 # operspywhois - If this is set then when an IRC operator uses #
727 # /WHOIS on a user they will see all channels, even #
728 # ones if channels are secret (+s), private (+p) or #
729 # if the target user is invisible +i. #
731 # customversion - If you specify this configuration item, and it is #
732 # not set to an empty value, then when a user does #
733 # a /VERSION command on the ircd, this string will #
734 # be displayed as the second portion of the output, #
735 # replacing the system 'uname', compile flags and #
736 # socket engine/dns engine names. You may use this #
737 # to enhance security, or simply for vanity. #
739 # maxtargets - The maxtargets field is optional, and if not #
740 # defined, defaults to 20. It indicates the maximum #
741 # number of targets which may be given to commands #
742 # such as PRIVMSG, KICK etc. #
744 # hidekills - The hidekills value, if set, replaces the source #
745 # of all oper-generated kills to be the given text #
746 # to provide anonimity to your opers. #
749 <security announceinvites="dynamic"
763 #-#-#-#-#-#-#-#-#-#-#-#-# LIMITS CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#
765 # This configuration tag defines the maximum sizes of various types #
766 # on IRC, such as the maximum length of a channel name, and the #
767 # maximum length of a channel. Note that with the exception of the #
768 # identmax value all values given here are the exact values you would #
769 # expect to see on IRC. This contrasts with the older InspIRCd #
770 # releases where these values would be one character shorter than #
771 # defined to account for a null terminator on the end of the text. #
773 # The identmax value has special meaning, as it may grow one #
774 # character longer than you specify, to accomodate for a ~ character #
775 # when m_ident is loaded. #
777 # These values should match network-wide, otherwise you may end up #
778 # with desyncs, and confusing your users by being able to use a nick #
779 # of a certain length on one server but not on another. Servers will #
780 # link with mismatched values, but this is NOT recommended as a long #
783 # Values here should be self explanitory: #
785 # maxnick - The maximum length of a nickname #
786 # maxchan - The maximum length of a channel name #
787 # maxmodes - The maximum number of parameterized mode changes #
789 # maxident - The maximum length of an ident/username value #
790 # maxquit - The maximum length of a quit message #
791 # maxtopic - The maximum length of a channel topic #
792 # maxkick - The maximum length of a kick message #
793 # maxgecos - The maximum length of a GECOS (real name) #
794 # maxaway - The maximum length of an away message #
808 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
812 # Logging is covered with the <log> tag, which you may use to change
813 # the behaviour of the logging of the IRCd.
815 # In InspIRCd as of 1.2, logging is pluggable and very extensible.
816 # Different files can log the same thing, different 'types' of log can
817 # go to different places, and modules can even extend the log tag
818 # to do what they want.
820 # An example log tag would be:
821 # <log method="file" type="OPER" level="default" target="opers.log">
822 # which would log all information on /oper (failed and successful) to
823 # a file called opers.log.
825 # There are many different types which may be used, and modules may
826 # generate their own. A list of useful types:
827 # - USERS - information relating to user connection and disconnection
828 # - CHANNELS - information relating to joining and parting of channels.
829 # XXX someone doc more on this
831 # You may also log *everything* by using a type of *, and subtract things out
832 # of that by using -TYPE - for example "* -USERINPUT -USEROUTPUT".
834 # The following log tag is highly default and uncustomised. It is recommended you
835 # sort out your own log tags. This is just here so you get some output.
836 <log method="file" type="* -USERINPUT -USEROUTPUT -m_spanningtree" level="default" target="ircd.log">
838 #-#-#-#-#-#-#-#-#-#-#-#-#- WHOWAS OPTIONS -#-#-#-#-#-#-#-#-#-#-#-#-#
840 # This tag lets you define the behaviour of the /whowas command of #
843 # groupsize - Controls the maximum entries per nick shown when #
844 # performing a /whowas nick. Setting this to 0 dis- #
845 # ables whowas completely. #
847 # maxgroups - The maximum number of nickgroups that can be added #
848 # to the list. If max is reached, oldest group will #
849 # be deleted first like a FIFO. A groupsize of 3 and #
850 # a maxgroups of 5000 will allow for 5000 nicks to #
851 # be stored with a history of 3, thus giving a total #
852 # of 3 * 5000 = 15000 entries. A setting of 0 dis- #
853 # ables whowas completely. #
855 # maxkeep - The maximum time a nick is kept in the whowas list #
856 # before being pruned. Time may be specified in #
857 # seconds, or in the following format: 1y2w3d4h5m6s #
858 # meaning one year, two weeks, three days, 4 hours, #
859 # 5 minutes and 6 seconds. All fields in this format #
860 # are optional. Minimum is 1 hour, if less InspIRCd #
861 # will default back to 1 hour. #
863 #<whowas groupsize="10" #
864 # maxgroups="100000" #
867 #-#-#-#-#-#-#-#-#-#-#-#-#-#- BAN OPTIONS -#-#-#-#-#-#-#-#-#-#-#-#-#-#
869 # The ban tags define nick masks, host masks and ip ranges which are #
870 # banned from your server. All details in these tags are local to #
874 # badip lines ban an ip range (same as a zline) #
876 # ipmask - The ip range to ban (wildcards possible) #
877 # CIDR is supported in the IP mask. #
878 # reason - Reason to display when disconnected #
880 # badnick lines ban a nick mask (same as a qline) #
882 # nick - Nick mask to ban (wildcards possible) #
883 # reason - Reason to display on /NICK #
885 # badhost lines ban a user@host mask (same as a kline) #
887 # host - ident@hostname (wildcards possible) #
888 # If you specify an IP, CIDR is supported. #
889 # reason - Reason to display on disconnection #
891 # exception lines define a hostmask that is excempt from [kzg]lines #
893 # host - ident@hostname (wildcards possible) #
894 # If you specify an IP, CIDR is supported. #
895 # reason - Reason, shown only in /stats e #
898 <badip ipmask="69.69.69.69" reason="No porn here thanks.">
900 <badnick nick="ChanServ" reason="Reserved For Services">
901 <badnick nick="NickServ" reason="Reserved For Services">
902 <badnick nick="OperServ" reason="Reserved For Services">
903 <badnick nick="MemoServ" reason="Reserved For Services">
905 <badhost host="*@hundredz.n.hundredz.o.1337.kiddies.com" reason="Too many 1337 kiddiots">
906 <badhost host="*@localhost" reason="No irc from localhost!">
907 <badhost host="*@172.32.0.0/16" reason="This subnet is bad.">
909 <exception host="*@ircop.host.com" reason="Opers hostname">
911 #-#-#-#-#-#-#-#-#-#-#- INSANE BAN OPTIONS -#-#-#-#-#-#-#-#-#-#-#-#-#-#
913 # This optional tag allows you to specify how wide a gline, eline, #
914 # kline, zline or qline can be before it is forbidden from being #
915 # set. By setting hostmasks="yes", you can allow all G, K, E lines, #
916 # no matter how many users the ban would cover. This is not #
917 # recommended! By setting ipmasks="yes", you can allow all Z lines, #
918 # no matter how many users these cover too. Needless to say we #
919 # don't recommend you do this, or, set nickmasks="yes", which will #
922 # The trigger value indicates how wide any mask will be before it is #
923 # prevented from being set. The default value is 95.5% if this tag is #
924 # not defined in your configuration file, meaning that if your #
925 # network has 1000 users, a gline matching over 955 of them will be #
926 # prevented from being added. #
928 # Please note that remote servers (and services) are exempt from #
929 # these restrictions and expected to enforce their own policies #
933 <insane hostmasks="no" ipmasks="no" nickmasks="no" trigger="95.5">
936 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#- YAWN -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
938 # You should already know what to do here :) #
940 <die value="User error. Insert new user and press any key. (you didn't edit your config properly.)">
942 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# MODULES #-#-#-#-#-#-#-#-#-#-#-#-#-#-#
943 # ____ _ _____ _ _ ____ _ _ _ #
944 # | _ \ ___ __ _ __| | |_ _| |__ (_)___ | __ )(_) |_| | #
945 # | |_) / _ \/ _` |/ _` | | | | '_ \| / __| | _ \| | __| | #
946 # | _ < __/ (_| | (_| | | | | | | | \__ \ | |_) | | |_|_| #
947 # |_| \_\___|\__,_|\__,_| |_| |_| |_|_|___/ |____/|_|\__(_) #
949 # Well done, you've reached the end of the basic configuration, your #
950 # ircd should now start if you want to try it out! (./inspircd start) #
952 # We now suggest you read and edit modules.conf, as modules are what #
953 # provide almost all the features of InspIRCd. :) #
955 # The default does nothing -- we include it for simplicity for you. #
956 <include file="modules.conf">
959 #########################################################################
961 # - InspIRCd Development Team - #
962 # http://www.inspircd.org #
964 #########################################################################