mirrors/ngircd
1
0
Fork 0
mirror of https://github.com/osmarks/ngircd.git synced 2024-12-12 01:40:27 +00:00
Code Issues Releases Wiki Activity
ngIRCd IRC server.
3,642 Commits 13 Branches 102 Tags 13 MiB
C 92%
Shell 4%
E 2.8%
Makefile 0.7%
Dockerfile 0.2%
Other 0.2%
24e822cff2
Go to file
Alexander Barton 24e822cff2 ngircd.8: Update for the now always available debug-mode
2024-03-31 11:19:48 +02:00
.github/workflows CI: Fix YAML, there shouldn't have been tabs in the file! 2024-01-21 01:51:46 +01:00
contrib Update and fix logcheck(8) rules 2024-03-31 11:19:48 +02:00
doc S2S-TLS: Convert SSL.txt to Markdown and update information given 2024-03-23 20:19:01 +01:00
man ngircd.8: Update for the now always available debug-mode 2024-03-31 11:19:48 +02:00
src S2S-SSL/GnuTLS: Enable CRL verification 2024-03-31 11:19:48 +02:00
.clang_complete Add ".clang_complete" file 2015-09-03 16:46:48 +02:00
.dockerignore Add a Dockerfile and documentation to the project 2024-03-17 22:42:15 +01:00
.editorconfig Add an ".editorconfig" file to the project 2016-05-07 00:43:30 +02:00
.gitignore Git: Streamline and simplify .gitignore file 2024-02-10 00:22:33 +01:00
.mailmap Add missing authors to AUTHORS, tweak ".mailmap" file 2020-05-10 00:16:11 +02:00
AUTHORS.md Update the AUTHORS.md file 2024-01-20 16:43:54 +01:00
autogen.sh autogen.sh: Prefere automake 1.11 over other releases 2024-01-16 22:32:33 +01:00
ChangeLog Use a default "IncludeDir" only when no config file was specified 2024-01-21 20:15:47 +01:00
config.guess Update config.guess and config.sub to recent versions 2024-01-11 15:12:54 +01:00
config.sub Update config.guess and config.sub to recent versions 2024-01-11 15:12:54 +01:00
configure.ng Update the mailing list address to ngircd@lists.barton.de 2024-01-20 16:43:54 +01:00
COPYING Update GPL 2 license text to current version 2011-11-06 21:53:15 +01:00
INSTALL.md S2S-TLS: Add notice to INSTALL.md 2024-03-23 20:23:29 +01:00
Makefile.am Update the "rpm" make target to use rpmbuild(8) 2024-03-17 22:42:19 +01:00
NEWS 2024 =:) 2024-01-11 15:11:56 +01:00
README.md Streamline README.md & INSTALL.md files 2024-03-23 20:15:16 +01:00

README.md

ngIRCd - Internet Relay Chat Server

Introduction

ngIRCd is a free, portable and lightweight Internet Relay Chat (IRC) server for small or private networks, developed under the terms of the GNU General Public License (GPL); please see the file COPYING for licensing information.

The server is quite easy to configure and runs as a single-node server or can be part of a network of ngIRCd servers in a LAN or across the internet. It optionally supports the IPv6 protocol, SSL/TLS-protected client-server and server-server links, the Pluggable Authentication Modules (PAM) system for user authentication, IDENT requests, and character set conversion for legacy clients.

The name ngIRCd stands for next-generation IRC daemon, which is a little bit exaggerated: lightweight Internet Relay Chat server most probably would have been a better name :-)

Status

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

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

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

Advantages and strengths

  • 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.

Documentation

The homepage of the ngIRCd project is https://ngircd.barton.de.

The INSTALL.md document describes how to install and upgrade ngIRCd. It is included in all distribution archives and available online on GitHub.

Please see the file doc/QuickStart.md in the doc/ directory or on GitHub for information about setting up and running ngIRCd, including some real-world configuration examples.

More information can be found in a couple of files in the doc/ directory (online on GitHub) and in the documentation section on the homepage of ngIRCd.

In addition, ngIRCd comes with two manual pages: ngircd(8) (for the daemon) and ngircd.conf(5) (for its configuration file). They have even more details and list all possible command line parameters and configuration options. You can read them with the man command (when they are installed locally on your system, e.g. man 8 ngircd and man 5 ngircd.conf) or online here:

Downloads & Source Code

You can find the latest information about the ngIRCd and the most recent stable release on the news and downloads pages of the homepage.

Visit our source code repository at GitHub if you are interested in the latest development code.

Problems, Bugs, Patches

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

See https://ngircd.barton.de/support for details.

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