The basic steps to setup an IrcD are install, configure and run...




You will need to add a source for ircd-hybrid to your /etc/apt/sources.list and run "apt-get update; apt-get install ircd-hybrid". We recommend that you build a deb in any case, because irc.indy uses a longer NICKLEN and TOPICLEN than normal.

ircd-hybrid is in debian official (sarge and later), but not in woody. For woody, try and If there are no stable/woody backports, then you will want to compile a .deb

Compiling a .deb

If you can't find an appropriate source for woody then add the following lines you your /etc/apt/sources.list. You will want to replace with your closest mirror.

deb-src unstable main
deb stable dpatch

Then run the following commands to get the packages required to build ircd-hybrid, and download the source code (inc debian patches).

mkdir ircd-hybrid-build
cd ircd-hybrid-build
apt-get update
apt-get install fakeroot
apt-get build-dep ircd-hybrid
apt-get source ircd-hybrid

The build-dep step will install debhelper, bison, libssl-dev, zlib1g-dev, dpatch (from, flex and docbook-to-man. You may want to edit debian/control & debian/ to remove docbook-to-man and use the stable version of debhelper. The package will still build no problems with the old debhelper and without dobook-to-man.

Then you will want to edit ./ircd-hybrid*/debian/rules, and change the parameters at the top to the following (to provide compatability with existing nodes):


Then build and install the package (you will need sudo/root access for that):

cd ircd-hybrid-7.0
dpkg-buildpackage -rfakeroot
sudo dpkg -i ../ircd-hybrid*.deb

After all that you will want to edit the configuration files for ircd-hybrid (see below). For debian these will be in /etc/ircd-hybrid/.

Direct from Source

You may want to install in a different location by changing the value of --prefix (including placing it in a stow)

If openssl is not properly detected by configure, you will need to use '--enable-openssl=/path/to/openssl'

Use the following if you are running a 2.4 kernel in gnu/linux:

./configure  --prefix=/usr/local/ircd-hybrid-7 \ 
--enable-openssl --with-maxclients=1000 \ 
--with-nicklen=25 --enable-rtsigio \ 
sudo make install

Create link to install path from /usr/local/ircd

Check ownership on ircd dir (irc.irc preferably - 'chown -R irc.irc ircd' if necessary). Make sure this is correct before starting the daemon.

When doing the configuring all the config files will be in /usr/local/ircd/etc/.


Acquire IMC template files/dirs from You can ask on the email list (ircd -at- or ask one of the ircd working group on in the channel #ircd.

You will need to configure ircd.conf: customize IMC default ircd.conf for your node, set server autoconnect for proper hub, create/copy keys directory, generating local rsa.key and if necessary:

openssl genrsa -out rsa.key 2048
openssl rsa -in rsa.key -pubout -out
chown irc.irc rsa.key
chmod 0600 rsa.key
chmod 0644

Create/copy ircd.motd. Touch optional logfiles if desired: logs/userlog, logs/operlog, logs/foperlog.


On debian, run '/etc/init.d/ircd-hybrid start'. On other platforms you will have to run the binary in another way.

Testing & troubleshooting

Check the output of 'ps aux' to make sure the ircd is running. Check the output of 'netstat -l' for an irc line to make sure the irc daemon is listening. Check the logs to find out what happened if the ircd is not running.

stunnel (ircs)

This should be run with these parameters:

stunnel -s irc -N ircs -d 994 -r

Web interface

See for instructions on how to setup qwebirc in our environment.
Topic revision: r9 - 13 Oct 2011, TheAnarcat
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback