UnrealIRCd/Tutorial 2
How to Set Up UnrealIRCD
This is a basic guide to setting up unrealircd.
First off you will need a copy of unrealircd (duh) to install. To do this go to the site and select a mirror and then get the download link the current link I got for example is http://files.alexisnet.net/unreal/Unreal3.2.7.tar.gz so to download that to our shell we type this
wget http://files.alexisnet.net/unreal/Unreal3.2.7.tar.gz
Now you should have the file Unreal3.2.7.tar.gz in your home folder (or wherever you were when you typed wget). We need to extract it now, type:
tar xzf Unreal3.2.7.tar.gz
now change directories to what we just extracted and run
./Config
Hit enter and then the spacebar 5-6 times and then hit enter again. If you want you can change these options as they are described on your screen but most of the time you can just hit enter through them all and not have any problems. Wait for it to finish (should be 10-20 seconds) and then run
make
now we need to copy the example configuration to our directory and name it unrealircd.conf so run
cp doc/example.conf unrealircd.conf
now open up the config with
vi unrealircd.conf
if you are on a Linux server, uncomment the following lines
loadmodule "src/modules/commands.so"; loadmodule "src/modules/cloak.so";
in the me block change your server name to whatever server you are on (example im using is pantalaimon.info) and then name your server and give it a numeric if you are not linking it with other servers you can leave the numeric to 1
me
{
name "pantalaimon.info";
info "Pantalaimon IRC Server";
numeric 1;
};
under the admin box you can put whatever but i recommend you at least put your email or nick so people can contact you.
admin {
"Cassandra aka Ariana";
"lyragamer@gmail.com";
};
you can skip the class lines in most cases the defaults are fine and go to the allow lines personally i hate that they have a bunch when i really only want one allow line so i delete all but
allow {
ip *@*;
hostname *@*;
class clients;
maxperip 5;
};
Now you can make your oper account like this
oper Ariana {
class clients;
from {
userhost *@*;
};
password "SecurePassHere";
flags {
can_override;
netadmin;
can_zline;
can_gzline;
};
};
Insert your name and userhost and password where they obviously go. To oper later on you would type for example /oper Ariana SecurePassHere with any vhost according to that oper block.
Now you can set your listening ports and ips. format is
listen IP:PORT;
port 194 is the rfc standard for irc but most common is 6667.
unless you are linking multiple servers just comment out the link blocks with a /* before the link hub.mynet.com and one after the }; right before New ulines comment. Also delete the comment in the middle in the options area so that it doesnt mess with your comment.
you can set the ulines if you want or leave them for now since i am not going into how to set up services (that will be my next tutorial)
change the passwords to kill and restart the server here
drpass {
restart "PUTSOMETHINGREALLYSECUREHERE";
die "SOMETHINGELSESECUREHERE";
};
if someone gets those passwords they can kill or restart your server so be careful.
Now you can skip down to tld lines which really is only useful if you have multiple motd and rulesets for people from different countries otherwise you can comment it out.
You can skip down to vhost lines and make a custom vhost that doesnt really need the vhost domain that shows
vhost {
vhost custom.vhost.here.com;
from {
userhost *@*;
};
login usernametousevhost;
password passwordtousevhost;
};
now for the set line yo uare setting up your basic server information pretty self explanatory
set {
network-name "PantalaimonIRC";
default-server "pantalaimon.info";
services-server "services.pantalaimon.info";
stats-server "stats.pantalaimon.info";
help-channel "#help";
hiddenhost-prefix "pan";
};
Now you need to set cloak keys doesnt matter what you set them to so long as they are random and include lowercase and uppercase letters with a few numbers
cloak-keys {
"jlsakfjdGFDsflka546jFSA5as2";
"sadfASDF2345asdfHGFasdfa43F";
"FJDSA23452SAFasdfaasfa435FD";
};
You can skip the on oper host if you want it sets your vhost when you oper if you want it to automatically set turn host-on-oper-up to "yes" and change the hostnames as you want them.
Now for the set block you NEED TO SET THE K-LINE EMAIL OR IT WILL NOT START PROPERLY
set{
kline-address "lyragamer@gmail.com";
modes-on-connect "+ixw";
modes-on-oper "+xwgs";
oper-auto-join "#opers";
options {
hide-ulines;
show-connect-info;
};
maxchannelsperuser 10;
anti-spam-quit-message-time 10s;
oper-only-stats "okfGsMRUEelLCXzdD";
throttle {
connections 3;
period 60s;
};
anti-flood {
nick-flood 3:60;
};
spamfilter {
ban-time 1d;
ban-reason "Spam/Advertising";
virus-help-channel "#help";
};
};
Save your config and do ./unreal start
if everything went well you should now be able to connect to your ircd.