# UnrealIRCd

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/SSL. (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:

    # unrealircd

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

Category:

- Internet Relay Chat