Knowledgebase

You will need to download UnrealIRCD and Anope source files to your ircd shell you want to install.

Next you will need to decompress the files:

tar xfz Unrealx.x.x.tar.gz
tar xfz anope-x.x.x.tar.gz

Installing and Configuring UnrealIRCD

cd Unrealx.x
./Config

Then you will now need to answer the questions asked
Now type make to compelete the process

make

Once complete you will need to create a config file using the example included in the install

cp doc/example.conf unrealircd.conf
Now we can make the modifications to get this working for you

pico unrealircd.conf
or
nano unrealircd.conf

Uncomment the following lines:

loadmodule "src/modules/commands.so";
loadmodule "src/modules/cloak.so";

Set your IRCD info

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

Show users you are the Admin

 admin {
 "Your Name";
 "Your NickName";
 "Your email address";
 };

Add your self as an Operator
oper YourNickHere {
 class           clients;
 from {
 userhost *@*;
 };
 password "YourPassHere";
 flags
 {
 netadmin;
 can_zline;
 can_gzline;
 can_gkline;
 global;
 local;
 admin;
 services-admin;
 can_localkill;
 can_globalkill;
 can_kline;
 can_unkline;
 can_setq;
 can_override;

};
 };

Add this IRC Service Section (do not edit the current lines)
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 this section out with /* */
/*
 link            hub.mynet.com
 {
 username    *;
 hostname     1.2.3.4;
 bind-ip     *;
 port         7029;
 hub             *;
 password-connect "LiNk";
 password-receive "LiNk";
 class           servers;
 options {
 /* Note: You should not use autoconnect when linking services */
 autoconnect;
 ssl;
 zip;
 };
 };
 */

Add a Uline entry

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

Comment this section out with /* */
/*
 tld {
 mask *@*.fr;
 motd "ircd.motd.fr";
 rules "ircd.rules.fr";
 };
 */

Now you can edit the network configuration
* 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 {
 "aoAr1HnR6gl3sJ7hVadasz4Zb7x4YwpW";
 "90jioIOjhiUIOH877hsads87UGU898hgF";
 "IOjiojiio8990UHUasdasHij89KJBBKU898";
 };
 /* 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";
 };
 };

Now edit the server configuration
/* 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;
 };

Save this file and test your configuration:
./unreal start

Installing and Configuring UnrealIRCD

First change to the Anope directory

cd anope-x.x.x

Then run the config

./Config

You will now need to answer the questions asked:
install binaries to? I suggest /path/to/Unrealx.x/services
 create dir? yes
 install data files to? hit enter
 group? hit enter
 default umask? hit emter
 MD5 passwd encryption? no (unless you really want it)
 auto-check for mysql libs? hit enter

Now Type make and make install to complete the process:

make
make install

Now browse to the services folder
cd /path/to/Unrealx.x/services

Create a services config file

cp example.conf services.conf

Now we need to make a few changes:

pico services.conf

IRCDModule "unreal32"
 RemoteServer 127.0.0.1 6667 "services"
 ServerName "services.yourdomain.com"
 ServicesRoot "YourNicknameHere"

Now save your file

You can test your config by running

./services -debug -nofork

To run normally

./services