Repository files navigation

ngIRCd is a free, portable and lightweightInternet Relay Chat (IRC)server for small or private networks, developed under the terms of the GNUGeneral Public License (GPL); please see the fileCOPYING for licensinginformation.

The server is quite easy to configure and runs as a single-node server or canbe part of a network of ngIRCd servers in a LAN or across the internet. Itoptionally supports the IPv6 protocol, SSL/TLS-protected client-server andserver-server links, the Pluggable Authentication Modules (PAM) system for userauthentication, IDENT requests, and character set conversion for legacyclients.

The name ngIRCd stands fornext-generation IRC daemon, which is a little bitexaggerated:lightweight Internet Relay Chat server most probably would havebeen a better name :-)

Development ofngIRCd started back in 2001: The server has been written fromscratch in C, tries to follow all relevant standards, and is not based on theforefather, the daemon of the IRCNet.

It is not the goal of ngIRCd to implement all the nasty behaviors of theoriginalircd or corner-cases in the RFCs, but to implement most of the usefulcommands and semantics that are used by existing clients.

ngIRCd is used as the daemon in real-world in-house and public IRC networksand included in the package repositories of various operating systems.

• Well arranged (lean) configuration file.
• Simple to build, install, configure, and maintain.
• Supports IPv6 and SSL.
• Can use PAM for user authentication.
• Lots of popular user and channel modes are implemented.
• Supports "cloaking" of users.
• No problems with servers that have dynamic IP addresses.
• Freely available, modern, portable and tidy C source.
• Wide field of supported platforms, including AIX, A/UX, FreeBSD, HP-UX,IRIX, Linux, macOS, NetBSD, OpenBSD, Solaris and Windows with WSL or Cygwin.

Thehomepage of the ngIRCd project ishttps://ngircd.barton.de.

TheINSTALL.md document describes how toinstall andupgrade ngIRCd. Itis included in all distribution archives and available online onGitHub.

Please see the filedoc/QuickStart.md in thedoc/ directory or onGitHub forinformation aboutsetting up andrunning ngIRCd, including some real-worldconfiguration examples.

More information can be found in a couple of files in thedoc/ directory(online onGitHub) and inthedocumentation section on thehomepage of ngIRCd.

In addition, ngIRCd comes with twomanual pages:ngircd(8) (for the daemon)andngircd.conf(5) (for its configuration file). They have even more detailsand list all possible command line parameters and configuration options. Youcan read them with theman command (when they are installed locally on yoursystem, e.g.man 8 ngircd andman 5 ngircd.conf) or online here:

• Daemon:ngircd(8)
• Configuration file:ngircd.conf(5)

You can find the latest information about the ngIRCd and the most recentstable release on thenews anddownloads pages of the homepage.

Visit our source code repository atGitHubif you are interested in the latest development code.

Please don't hesitate to contact us if you encounter problems:

• On IRC: irc://irc.barton.de/ngircd
• Via the mailing list:ngircd@lists.barton.de

Seehttps://ngircd.barton.de/support for details.

If you find any bugs in ngIRCd (which most probably will be there ...), pleasereport them to our issue tracker at GitHub:

• Bug tracker:https://github.com/ngircd/ngircd/issues
• Patches, "pull requests":https://github.com/ngircd/ngircd/pulls