The IRCsystems Blog

It seems there is often a lot of confusion when it comes to getting UnrealIRCd to link with your preferred services package, so I have put together some examples on helping you get everything put together.

UnrealIRCd Configuration

The first step is to add your linking configuration to Unreal. In this example I have provided the options to include the aliases configuration by uncommenting the appropriate include line. Change all the services.example.net server names to the proper services server name for your network. I recommend keeping all your server names lowercase to avoid confusion and conflicts later.

I recommend always connecting services on the 127.0.0.1 (localhost) interface to assist in keeping weirdos away from your packets.

The set, ulines, and alias configuration must be done on all servers in your network.

// UnrealIRCd :: http://unrealircd.org
// unrealircd.conf

# include aliases/anope.conf;
# include aliases/atheme.conf;

listen 127.0.0.1:6667;

ulines { services.example.net; };

link services.example.net
{
    username *;
    hostname 127.0.0.1;
    port 6667;
    password-connect *;
    password-receive "password";
    class servers;
};

set {
    services-server services.example.net;
    # ...
};

Services Configuration

Here are the configuration snippets that go into your services configuration file for the settings related to connecting to your server. Remember to rename services.example.net to the proper name of your services server. Again, I recommend keeping the names of your services all lowercase to avoid confusion and conflicts later.

Anope

// Anope :: http://anope.org
// services.conf

RemoteServer 127.0.0.1 6667 "password"
ServerName "services.example.net"
ServerDesc "Example Services"

Atheme

// Atheme :: http://atheme.org
// atheme.conf

serverinfo
{
    name = services.example.net;
    desc = "Example Services";
    # ...
};

uplink irc.example.net
{
    host = 127.0.0.1;
    password = "password";
    port = 6667;
};

Common Problems

I get unknown command when trying to use services.

You likely have not included or created the proper aliases blocks. The easiest thing to do would be to uncomment the proper include line for your services in the UnrealIRCd portion of this example.

Services are currently down…

There are a few causes to this:

• Your services are not connected.
• You didn’t change the servernames in the examples.
• Your services aren’t u:lined (check the ulines block).

Nothing happens at all when I use services commands.

This commonly happens when you mix upper and lowercase server names. Make sure all your services server names are exactly the same in every configuration!