Difference between revisions of "UnrealIRCd"

From ArchWiki
Jump to navigation Jump to search
(→‎Configuring (mandatory): update docs link)
(→‎Starting/Stopping the daemon: unrealircd will refuse to run as root)
Line 21: Line 21:
 
If you run into problems where the daemon will not start, try running:
 
If you run into problems where the daemon will not start, try running:
  
  # unrealircd
+
  $ sudo -u ircd unrealircd
  
 
It will print out the errors and what line they occur on. Often errors are due to problems in your configuration.
 
It will print out the errors and what line they occur on. Often errors are due to problems in your configuration.

Revision as of 21:33, 13 December 2019

UnrealIRCd (Unreal IRC daemon) is an open source IRC Server. Development of UnrealIRCd began in May of 1999. Unreal was created from the Dreamforge IRCd that was formerly used by the DALnet IRC Network. Over the years, many new and exciting features have been added to Unreal. It is hard to even see a resemblance between the current Unreal and Dreamforge.

Installing UnrealIRCd

Install the unrealircd package.

Configuring (mandatory)

Many of the settings you'll want to set are very dependent on how you will use your IRC server. There is a default configuration but it doesn't work out of the box.

From there you'll want to follow the UnrealIRCd Configuration docs making sure to configure all of the required fields such as me, admin, class, etc.

Place your SSL key/cert at /etc/unrealircd/ssl/server.key.pem and /etc/unrealircd/ssl/server.cert.pem. If you do not have a proper certificate, you can generate a self-signed one, as explained at Apache HTTP Server#TLS. (note that the files have to be named slightly different for UnrealIRCd)

Starting/Stopping the daemon

You can start and stop the UnrealIRCd daemon with the unrealircd.service systemd unit.

If you run into problems where the daemon will not start, try running:

$ sudo -u ircd unrealircd

It will print out the errors and what line they occur on. Often errors are due to problems in your configuration.