# make sure that they correspond to your installation and setup!
# Server name in the IRC network, must contain at least one dot
- # (".") and be unique in the IRC network. Required!
- Name = irc.example.net
+ # (".") and be unique in the IRC network. When not set, ngIRCd tries
+ # to deduce a valid IRC server name from the local host name.
+ ;Name = irc.example.net
# Information about the server and the administrator, used by the
# ADMIN command. Not required by server but by RFC!
;AdminEMail = admin@irc.server
# Text file which contains the ngIRCd help text. This file is required
- # to display help texts when using the "HELP <cmd>" command.
+ # to display help texts when using the "HELP <cmd>" command. Default: a
+ # built-in standard path (check "ngircd --configtest").
;HelpFile = :DOCDIR:/Commands.txt
# Info text of the server. This will be shown by WHOIS and
- # LINKS requests for example.
- Info = Server Info Text
+ # LINKS requests for example. Set to the server software name and
+ # version by default.
+ ;Info = Server Info Text
# Comma separated list of IP addresses on which the server should
# listen. Default values are:
;Listen = 127.0.0.1,192.168.0.1
# Text file with the "message of the day" (MOTD). This message will
- # be shown to all users connecting to the server:
+ # be shown to all users connecting to the server: Default: a built-in
+ # standard path (check "ngircd --configtest").
;MotdFile = :ETCDIR:/ngircd.motd
- # A simple Phrase (<256 chars) if you don't want to use a motd file.
+ # A simple Phrase (<127 chars) if you don't want to use a motd file.
;MotdPhrase = "Hello world!"
# The name of the IRC network to which this server belongs. This name
# Directory containing configuration snippets (*.conf), that should
# be read in after parsing this configuration file.
+ # Default: a built-in directory name when no configuration file was
+ # explicitly given on the command line (check "ngircd --configtest"),
+ # none (empty) otherwise.
;IncludeDir = :ETCDIR:/conf.d
# Enhance user privacy slightly (useful for IRC server on TOR or I2P)
[Server]
# Other servers are configured in [Server] sections. If you
# configure a port for the connection, then this ngircd tries to
- # connect to to the other server on the given port; if not it waits
+ # connect to the other server on the given port; if not it waits
# for the other server to connect.
# There may be more than one server block, one for each server.
#
# Topic for this channel
;Topic = a great topic
- # Initial channel modes
- ;Modes = tnk
+ # Initial channel modes, as used in "MODE" commands. Modifying lists
+ # (ban list, invite list, exception list) is supported.
+ # This option can be specified multiple times, evaluated top to bottom.
+ ;Modes = +tnk mykey +l 5
+ ;Modes = +b nick!~user@bad.host.example.com
- # initial channel password (mode k)
- ;Key = Secret
+ # Should ngIRCd automatically join ("autojoin") all users to this
+ # channel on connect? Note: The users must have permissions to access
+ # the channel, otherwise joining them will fail!
+ ;Autojoin = yes
# Key file, syntax for each line: "<user>:<nick>:<key>".
# Default: none.
;KeyFile = :ETCDIR:/#chan.key
- # maximum users per channel (mode l)
- ;MaxUsers = 23
-
[Channel]
# More [Channel] sections, if you like ...