How to Install Unreal Ircd

Hopefully you have already downloaded the source. If not, you can find it here: http://www.unrealircd.com. After you have downloaded that, fire up your favorite ftp client and upload it to the root directory of your shell. You could also get the source by using lynx or wget. Example wget command:

wget http://www1.dnwt.net/unreal/Unreal3.2.3.tar.gz

The next step is to decompress this file (.tar.gz is kinda like a .zip file for all you windoze ppl out there). To do this, type:

tar zxvf Unreal3.2.3.tar.gz

Notice that it's case-sensitive. Everything in unix is case-sensitive. Keep that in mind for everything in the future. You can now remove the file you downloaded with the following command:

rm Unreal3.2.3.tar.gz

Now that we've untarred our UnrealIRCd file, we need to move to that directory:

cd Unreal3.2

And now that we're in the Unreal directory, we need to run the configuration wizard:

./Config

So we've got the script running. The first thing you're greeted with is the release notes for Unreal 3.2.3, now this is a lot of reading, and isn't really necessary, so just press enter once, then spacebar until you see:

==[ ADDITIONAL INFO ]==
* See ChangeLog
[Enter to continue]

Press enter and you'll be greeted with the first question.

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

I've never actually come across a server that uses this, so just press enter to move on to the second question.

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

Well we haven't changed the directory, so just press enter to move on to the third question.

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

Again, we haven't changed this path, so just press enter to move on to the fourth question.

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

If you're not going to link your server to any other IRC servers, just press enter. However, if you are going to link your server to another IRC server, and this server is going to be a leaf on that network, type 'Leaf' and press enter. If you are linking your server to another IRC server and your server will be the Hub, just press enter.

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

This question has already been answered for you by the configuration script, so just press enter to move on to 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] - >

The default value for this question is the one you should use, so just press enter.

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

Not many servers use this method of connection, and I doubt you will need to, and if you did, you'd know if you did, so just press enter to move on.

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

You definitely don't need this feature, so just press enter to move on to the next question.

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

You don't really need this feature either, and if you did, you'd know you did (sound familiar?) so press enter.

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

You don't really need this, so just press enter to move on to the next question. Getting monotnous now isn't it? Hang in there.

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, etc.) with the notable exceptions of irssi, KVIrc and CGI:IRC.
This feature should be enabled/disabled network-wide.
[No] ->

Well now, this is a nice feature. It pretty much explains itself though... 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. Either type 'Yes' if you want to enable this feature, or just press enter if you don't 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] ->

This value doesn't need to be edited, so press enter to move on to the next question.

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

This value doesn't need to be edited either, so press enter to move on.

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

You guessed it, you don't need to edit this either. Press enter to move on to the next question.

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

And yet again ... just press enter to move on.

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

You do need to change this value (wahey!), to however many users are allowed to connect to your IRCd.

Would you like any more parameters to configure?
Write them here:
[] ->

No, we don't want to configure anything else, so just press enter and sit back while it compiles itself. You might be thinking that there were a lot of questions that you didn't need to answer, but some networks do, so don't worry any more about that.

After that has finished compiling (it should take about a minute) you'll see the following message amongst some fancy borders and other information:

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.

Hey, this script is taking over my job, telling you what to do! Okay then, just type 'make' and ... let it compile, this should take a little longer than it did last time. When it's finished, you'll see a message beginning with:

Compile is now complete. You should now read the documentation and learn how to configure your IRCd as it is out of scope as you have to configure it as per your requirements, all networks have different requirements.

After you have edited unrealircd.conf, you can start Unreal from your shell. In the Unreal3.2 directory, type the following command:

./unreal start

If you receive no errors, you should now be able to connect to your IRCd!