Install (Setup / Compile) Unreal IRCD

1.) Type: wget http://unreal.brueggisite.de/Unreal3.2.8.1.tar.gz

Above command will download unreal ircd in tar format on your shell. now you have to untar your unreal ircd.
For that type command given below:

2.) Type: tar -zxvf Unreal3.2.8.1.tar.gz

This will untar your unreal ircd and extract all files in Unreal3.2 dir. Now you have to change directory to Unreal3.2.

3.) Type: cd Unreal3.2

Now we are moved to directory Unreal3.2 and now you are ready to configure your ircd. So lets start with following command.

4.) Type: ./Config

Your configuration of unreal ircd has been started. Now you have to press “Enter key” once and then “space bar” until you see
following questions.

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

To enable anti-spoof protection option type yes and enter or leave if you want to keep it disabled then just leave it blank and press enter. According to my suggestion keep it blank.

What directory are all the server configuration files in?
[/home/username/Unreal3.2] ->

We didn’t change the directory so keep it blank and press enter.

What is the path to the ircd binary including the name of the binary?
[/home/username/Unreal3.2/src/ircd] ->

Again keep it blank and press enter as we didn’t changed this path.

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

f you are not going to link your ircd with any other irc server then just keep it blank and press enter.

If you want to link your ircd to other irc servers then type leaf and press enter.

What is the hostname of the server running your IRCd?
[ircd.webshost.net] ->

You don’t need to change anything here so just press enter for the next question.

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] ->

Answer has been already given automatically by configuration script so just press enter and go for next question.

Do you want to support SSL (Secure Sockets Layer) connections?
[No] ->

Many servers does not use this option so my recommendation for you is to leave it blank and go ahead for next question. But if you want to enable this option just type yes and go ahead.

Note: if you are pressing yes you should know what you are doing.

Assuming that you have kept that blank, we are moving to our next question

Do you want to enable IPv6 support?
[No] ->

If you want to enable this option type yes and go ahead. We are keeping it here disabled.

Do you want to enable ziplinks support?
[Yes] ->

You really don’t need feature either, so keep it blank or yes.

Do you want to enable remote includes?
[No] ->

No, its not recommended.

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] ->

Its a cool feature. You might like it to keep it enable. If you have registered the channel, you will be ~yournick instead of @yournick in the channel, and anyone who you have added to the SOP list, or who is +a in the channel, will be &theirnick instead of @theirnick. Type no if you dont want it.

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] ->

Again keep it blank as we do not need to change this value.

How far back do you want to keep the nickname history?
[2000] ->

Again keep it blank as we do not need to change this value.

What is the maximum sendq length you wish to have?
[3000000] ->

Keep it blank again.

How many buffer pools would you like?
This number will be multiplied by MAXSENDQLENGTH.
[18] ->

es you guessed it right, keep it blank again.

How many file descriptors (or sockets) can the IRCd use?
[1024] ->

Now this answer depends upon how many users are allowed on your ircd.

Suppose if you have purchased 300 user ircd package then type 300, if you have 1000 user ircd then type 1000.

Just keep it blank and press enter.

Your Ircd will get started to configured now. So just wait until its get configured completely.

You might be thinking that we left most of the question blank, well don’t worry you don’t need those options. And when ever you need you can turn them on or off accordinly.

At the end of configuration you will see following msg in box

Now all you have to do is type ‘make’ and let it compile. When that’s done, you will receive other instructions on what to do next.

so just type following command.

5.) Type: make

Now your unreal ircd is getting compiled. It might take bit long. So now just wait to get it compiled.

At the end of compiling you will get following msg in box:

Compile is now complete. You should now read the documentation and learn how to configure your IRCd.

Now we need unrealircd.conf file in directory Unreal3.2 and need to edit it to start and work our ircd perfactly.

6.) Type: cp /home/username/Unreal3.2/doc/example.conf unrealircd.conf

“username” should be replace with your ircd shell’s username.

Above command will create unrealircd.conf file in your Unreal3.2 directory.

Now you have to edit it.

7.) Type: pico unrealircd.conf

Everything in this file has been explained in details. So I don’t have to explain it all again. I will go through the most important ones.

note: Don’t modify any other variables unless you are aware of it.

so Now lets start editing.

/* FOR *NIX, uncomment the following 2lines: */
loadmodule “src/modules/commands.so”;
loadmodule “src/modules/cloak.so”;

# To uncomment it just remove “//” from the begining of lines.

# Now Its time for Ircd info block to be edited.

me
{
name “irc.yourdomain.com”;
info “your IRC network name”;
numeric 1;
};

# In this block You can add your ircd info.

# Add your info as admin

admin {
“Your Name”;
“Your Nickname”;
“your@email.addr”;
};

# Now Add an O:Line for yourself
# You can edit the one already there
# O:Lines define the IRCops

Now,

# Add a C/N Line for IRC Services
# Don’t edit the link block already there.
# C/N Lines allow other IRCDs or IRC Services to link with you

link services.yourdomain.com
{
username *;
hostname 127.0.0.1;
bind-ip *;
port 7029;
hub *;
password-connect “services”;
password-receive “services”;
class servers;
options {
};
};

# Comment following black out with /* */

/*
link hub.mynet.com
[..etc..]
options {
/* Note: You should not use autoconnect when linking services */
autoconnect;
ssl;
zip;
};
};
*/

# Add the U:Line for the IRC Services
# You can edit the ulines block already there

ulines {
services.yourdomain.com;
stats.yourdomain.com;
};

# Comment this out with /* */

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

# Network configuration is the most important part
# You can use the block already there

* Network configuration */
set {
network-name “YourNetworkNameHere”;
default-server “irc.yourdomain.com”;
services-server “services.yourdomain.com”;
stats-server “stats.yourdomain.com”;
help-channel “#help”;
hiddenhost-prefix “hidden”;
/* prefix-quit “no”; */
/* Cloak keys should be the same at all servers on the network.
/* [..etc..]
*/
cloak-keys {
“aoAr1HnR6gl3sJ7hVz4Zb7x4YwpW”;
“90jioIOjhiUIOH877h87UGU898hgF”;
“IOjiojiio8990UHUHij89KJBBKU898″;
};
/* on-oper host */
hosts {
local “locop.yourdomain.com”;
global “ircop.yourdomain.com”;
coadmin “coadmin.yourdomain.com”;
admin “admin.yourdomain.com”;
servicesadmin “csops.yourdomain.com”;
netadmin “netadmin.yourdomain.com”;
host-on-oper-up “no”;
};
};

# Server configuration
# You can edit the block already there

/* Server specific configuration */

set {
kline-address “VALID.mail@address.here”;
auto-join “#lobby”;
modes-on-connect “+ixw”;
modes-on-oper “+xwgs”;
oper-auto-join “#opers”;
dns {
nameserver Your.DNS.IP.Here;
timeout 2s;
retries 2;
};

Your unrealircd.conf has been edited now.

8.) type: ctrl (key)+x
(to save your unrealircd.conf file)

9.) type: y + enter (key)

You have to start your unreal ircd process to test your new ircd server. for that type following command

10.) Type: ./unreal start

Now your unreal ircd has been started and you can connect to your ircd server.