What is VDS?

ISPmanager control panel

Documentation

Software packages for VDS

FAQ

>> Installing Unreal IRCD

- Setting up UnrealIRCD on FreeBSD

- Setting up UnrealIRCD on Debian Linux

UnrealIRCd is one of the most popular IRC server that is available for free. It runs on both FreeBSD and Linux, and is highly configurable. Setting up UnrealIRCd is relatively simple; just follow the steps below to get started.

NOTE: Lines that start with # are my comments so you don't have to add them to the config file.

Setting up UnrealIRCD on FreeBSD

Before you start, you need to install c-ares (an asynchronous resolver library)

# cd /usr/ports/dns/c-ares
# make install clean

Continue with UnrealIRCd installation:

# cd /usr/ports/irc/unreal/
# make install clean

Put the ticks:

[X] HUB Configure as a hub (otherwise configure as a leaf)
[X] ZIPLINKS Enable ziplinks support
[X] SSL Support SSL connecions

After successful installation, set server. The configuration is here: /usr/local/etc/Unreal/unrealircd.conf

The following line needs to be either commented out. Delete //

//loadmodule "/usr/local/lib/Unreal/commands.so";
//loadmodule "/usr/local/lib/Unreal/cloak.so";

In the config file /usr/local/etc/Unreal/unrealircd.conf find the below lines:

{
  name "irc.foonet.com";
  info "FooNet Server";
  numeric 1;
};

Change them with your server name.

Show users you're the admin - "Your Name", "Your Nickname", "your@email.addr":

admin {
  "Bob Smith";
  "bob";
  widely@used.name;
};

Add your email address (name@domain.ru)

kline-address "set.this.email";

for the set.this.email.

The options below allows to hide users' hosts from other users:

  cloak-keys {
  "aoAr1HnR6gl3sJ7hVz4Zb7x4YwpW";
  "and another one";
  "and another one";
  };

Replace them with random lines (latin letters, numbers, 5-20-symbol length):

  cloak-keys {
  "BNk547Vjj548bgd6b43bxxXdhyd";
  "fG43Jd65kxx843xx4z461xYdoOxg";
  "MJJ7GJfgv7CFkp7288oXkKxqQec";
  };

The below lines define the IRCops:

oper YourNickHere # Nickname of the operator
{
  class clients; #Class of the operator
  from {
  userhost bob@smithco.com; #Host and ident of the operator (you can use *@*
  };
  password "YourPassHere"; # Password of the operator
  flags
  {
  netadmin; # Privileges of the operator
  global;
  };
};

Set passwords for the server:

drpass {
  restart "restart-password";
  die "shutdown-password";
};

Add SSL connections support. Though this makes the connections a bit slow, it is highly recommended for people who care utmost about security and privacy. Enabling SSL ensures privacy for users. You need to use self signed certificates.

# cd /usr/local/etc/Unreal
# openssl req -newkey rsa:1024 -nodes -keyout server.key.pem -out server.cert.pem -x509 -days 3650 -subj "/C=XX/ST=XX/L=XX/O=XX/OU=XX/CN=your.server.hostname/emailAddress="your@email.addr

Add autostart for your server by setting the unrealircd_enable="YES" tag in /etc/rc.conf:

Now that you are finished making the configuration file. It's time to test your new IRCD server by typing:

# /usr/local/etc/rc.d/unrealircd start

If you get some warning messages, it's safe to ignore them. If you get error messages, you'll have to get to the bottom of them, alone. Check the log-file /var/log/ircd/ircd.log

That's all to it. Remember to allow incoming connections on ports 6667.

table of contents | on top

Setting up UnrealIRCD on Linux (debian-4.0-mimimal)

First you should install gcc compiler since the template excludes it.

# apt-get update
# apt-get install gcc
# apt-get install libc6-dev
# apt-get install make

You will also need to have OpenSSL:

# apt-get install openssl
# apt-get install libssl-dev

It's not recommended to run IRCd as root. So create another user using linuxconf 'adduser':

# adduser ircd

Download UnrealIRCD package from HERE:

$ wget http://unrealircd.pimpmylinux.org/Unreal3.2.7.tar.gz

Decompress it:

$ tar xzvf Unreal3.2.7.tar.gz

Create a directory where you will install UnrealIRCd in:

$ mkdir -p /home/ircd/unreal/bin
$ mkdir /home/ircd/unreal/conf

Compile UnrealIRCD:

$ cd Unreal3.2.7/
$ ./Config

The config tool shall ask you a few. Answers you should use during the install process:

Do you want to enable the server anti-spoof protection?
[No] ->

What directory are all the server configuration files in?
[/home/ircd/Unreal3.2.7] -> /home/ircd/unreal/conf -> {Press Enter}

What is the path to the ircd binary including the name of the binary?
[/home/ircd/Unreal3.2.7/src/ircd] -> /home/ircd/unreal/bin/ircd -> {Press Enter}

Would you like to compile as a hub or as a leaf?
Type Hub to select hub and Leaf to select leaf.
[Hub] ->

What is the hostname of the server running your IRCd?
[myircserver.com] -> {Hit Enter}
What should the default permissions for your configuration files be? (Set this to 0 to disable)
It is strongly recommended that you use 0600 to prevent unwanted reading of the file
[0600] -> {Hit Enter}

Do you want to support SSL (Secure Sockets Layer) connections?
[No] ->  {Press Enter} (or Yes if you are a security addict)
If you know the path to OpenSSL on your system, enter it here. If not
leave this blank
[] ->
Do you want to enable IPv6 support?
[No] -> {Hit Enter}

Do you want to enable ziplinks support?
[No] (unless you're linking with another IRCD) ->

For the next few questions, just press enter to make use of the default options. Standard values are listed and should be changed only to fine tune the server.

If you know the path to zlib on your system, enter it here. If not
leave this blank
[] ->
Do you want to enable remote includes?
[No] ->
Do you want to enable prefixes for chanadmin and chanowner?
This will give +a the & prefix and ~ for +q (just like +o is @)
Supported by the major clients (mIRC, xchat, epic, eggdrop, Klient,
PJIRC, irssi, CGI:IRC, etc.)
This feature should be enabled/disabled network-wide.
[Yes] ->
What listen() backlog value do you wish to use? Some older servers
have problems with more than 5, others work fine with many more.
[5] ->
How far back do you want to keep the nickname history?
[2000] ->
What is the maximum sendq length you wish to have?
[3000000] ->
How many buffer pools would you like?
This number will be multiplied by MAXSENDQLENGTH.
[18] ->
How many file descriptors (or sockets) can the IRCd use?
[1024] ->
Would you like any more parameters to configure?
Write them here:
[]->

Once the questionnaire has been answered, compilation shall config UnrealIRCd.

./configure --with-showlistmodes --enable-hub --enable-ssl --enable-ziplinks --enable-prefixaq --with-listen=5 --with-dpath=/home/ircd/unreal/conf --with-spath=/home/ircd/unreal/bin/ircd --with-nick-history=2000 --with-sendq=3000000 --with-bufferpool=18 --with-hostname=ls-test-linux.firstvds.ru --with-permissions=0600 --with-fd-setsize=1024 --enable-dynamic-linking

Just type make on your shell and unrealircd shall now compile your IRC server.:

$ make install

Only compilation is achieved by the above command. You still need to configure the IRC server in accordance to your needs.

Copy the following:

$ cd /home/ircd/unreal/conf
$ cp doc/example.conf unrealircd.conf

Now you should add SSL certificates:

$ cd /home/ircd/unreal/conf
$ openssl req -newkey rsa:1024 -nodes -keyout server.key.pem -out server.cert.pem -x509 -days 3650 -subj "/C=XX/ST=XX/L=XX/O=XX/OU=XX/CN=имяyour.server.(hostname)/emailAddress="your@email.addr

Open unrealircd.conf and modify it the same way as described in the tutorial for FreeBSD

Specify the path:

loadmodule "/home/ircd/unreal/conf/modules/commands.so";
loadmodule "/home/ircd/unreal/conf/modules/cloak.so";

Add the lines defining the IRCops (our server name, the operator of the server).

Также Comment this out with /* */

/*
 * tld {
 * mask *@*.fr;
 * motd "ircd.motd.fr";
 * rules "ircd.rules.fr";
 * };
 */

You can also create the files ircd.motd.fr and ircd.motd.fr in /home/ircd/unreal/conf (variants are available).

Start your new IRCD server:

$ /home/ircd/unreal/bin/ircd

If the IRCd server has not been started, check /home/ircd/unreal/conf/ircd.log

If Unreal started OK, add autostart for it by using crontab (ircd user). The command is crontab -e

Start nano (hints will be displayed at the buttonm of the screen). Set up task to run after each server reboot by typing:

@reboot /home/ircd/unreal/bin/ircd

Press ctrl+x to save and enter to confirm. Crontab -l checks whether the task has been set up or not.

Enjoy your IRC server.

table of contents | on top