From ArchWiki
Revision as of 20:53, 17 April 2012 by Pithdillinja (talk | contribs) (Configuring (manditory): Fixed spelling error: manditory is now mandatory)
Jump to navigation Jump to search

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.

Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어

External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

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 from the community repo:

pacman -S unrealircd

Configuring (mandatory)

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

The files in /etc/unrealircd/ are not viewable by users, only root can see/read/edit the files in this directory.

The first thing you'll want to do when setting up UnrealIRCd is to open /etc/unrealircd/unrealircd.conf and find the lines where it says FOR *NIX, uncomment the following 2lines and uncomment them. You'll also need to remove the src/ from the start of the path, as they are in the modules directory under /etc/unrealircd/

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

As far as I could tell, you do not get even snake oil certs with the UnrealIRCd package. I am sure there are other (easier) ways to generate the certs, but my solution was to use ABS to build the package, then went into src/ and ran:

make pem

Which will ask you a series of questions, if you are running a public facing server you should answer them honestly, if you are not, then the answers do not really matter.

Starting/Stopping the daemon

You can start and stop the UnrealIRCd daemon as usual by running:

sudo /etc/rc.d/unrealircd {start|stop|restart}

If you run into problems where the daemon wont start, I recommend running:

sudo unrealircd

It will spew out the errors and what line they occur on. Often it is due to problems in your configuration.