InspIRCd - 10,000 revisions reached!

From the makers of InspIRCd.

Contents 1 Getting Started 2 Configuration 3 Link Blocks 4 Modules

Getting Started

To get atheme working with InspIRCd, you must first download atheme from the atheme website. It is recommended that you download the latest stable release. Untar it, and run

./setup

and answer the questions the few questions, if unsure, leave the defaults(press enter instead of entering in a value).

Configuration

Open up atheme/etc/example.conf and save it as atheme.conf. Now you must edit the file so it works correctly with inspircd. When configuring atheme, you must ensure that you load the correct protocol module, as shown in the example below:

loadmodule "protocol/inspircd11";

Link Blocks

Your next step should be to add the link blocks, bind blocks, and uline blocks to your inspircd server. Here are some examples of correctly formatted link blocks for a services server:

<bind address="" port="7252" type="servers">

<link name="services-dev.chatspike.net"
      ipaddr="localhost"
      port="7252"
      sendpass="XXXXX"
      recvpass="XXXXX">

<uline server="services-dev.chatspike.net">

The bind block tells the server to open up that port and set it to listen to servers only. The link block gives permmision to your services package to connect to your ircd. The uline allows services to have extra powers servers normally don't get. Make sure the bind port and the port in the link name is the same.

After you add the link blocks, you must change atheme.conf to match you link blocks. Look in the server info block. Make sure the name matches the name you put in your inspircd.conf. Then look into the uplink section. Put your server name in quotes where it tells you to. Change the host to where you want services to connect (if its on the same machine as your ircd, keep it as localhost). Then change the password and port to what you put in your link block.

Modules

You must load the following modules in inspircd for atheme to work:

<module name="m_services_account.so">
<module name="m_spanningtree.so">
<module name="m_svshold.so">

Optionally, the following modules may enhance services support:

<module name="m_globops.so">
<module name="m_operchans.so">
<module name="m_redirect.so">
<module name="m_chanprotect.so">
<module name="m_blockcolor.so">
<module name="m_banexception.so">
<module name="m_inviteexception.so">
<module name="m_cloaking.so">
<module name="m_knock.so">
<module name="m_noctcp.so">
<module name="m_nokicks.so">
<module name="m_nonotice.so">
<module name="m_nonicks.so">
<module name="m_noinvite.so">
<module name="m_censor.so">
<module name="m_stripcolor.so">

Also, the m_alias.so module is highly useful (but optional) for redirecting commands to services automatically.

Once you are finished configuring, rehash inspircd (/rehash) and start atheme (go into atheme/bin and run the atheme-services program).