This site is deprecated; docs have moved to docs.inspircd.org!
Installation From Source
Building and Installing InspIRCd
There are two choices for downloading InspIRCd. Depending on the resources available to you, and what you require, you can either install it from a tarball, or via svn. The two possibilities are documented below.
Download the latest tarball from the InspIRCd website, here
Check out the latest version of InspIRCd from our subversion (SVN) repository, either get a tarball of it from ViewVC here. You can check it out of SVN directly with this command for trunk:
svn co http://svn.inspircd.org/repository/trunk/inspircd inspircd
or this for the 1.1 stable branch:
svn co http://svn.inspircd.org/repository/branches/1_1_stable inspircd
Trunk vs. Stable
Trunk is for adventurous people and those who want their hotfixes steaming hot. We branched InspIRCd into two versions, trunk and 1_1_stable (1.1 stable):
- Trunk receives active development of NEW FEATURES, as well as fixes. It is usually not as stable as the branches.
- 1.1 stable is the stable branch, which receives only fixes and is the most stable and recommended for production use.
- 1.0 stable is a legacy branch, which is no longer maintained.
If you got a tarball of InspIRCd (not directly from SVN) then extract it with:
tar xjf tarballfilename.tar.bz2
Optional: Add Extra Modules
If you want to add any modules with dependencies in src/modules/extra/ then do this now (Note: ./configure automatically does this for the ssl modules if you answer yes and it detects the required libraries):
cd src/modules ln -s extra/m_moduleiwant.cpp
Also if you want to add any modules from the Unofficial Modules SVN Repository then do this now, make sure you copy or link them to src/modules.
NOTE: This is an optional example. Do not type this command literally, and do not symlink anything unless you need it! If you have already built InspIRCd once, you may proceed to Adding Modules.
Run the ./configure script in the InspIRCd base directory and enter the details of your server when prompted. Remember that the values you enter here are constrained by the 512 maximum character limit on a line, so there's no point setting the maximum topic length to 1024 chars when you're only going to be able to use about 420 of them.
Type 'make' to build the ircd binaries, if configure has not already done this. Then type 'make install' to install them, you can skip 'make' and go straight to 'make install' if you're lazy. It'll work.
Configuring and Running
Edit your Configuration files, it's easiest to copy docs/inspircd.conf.example to conf/inspircd.conf and edit that. See the Modules List to find specific documentation for modules' config. See the wiki page on Configuration for more details on the core configuration.
Start inspircd with ./inspircd start, make sure you execute the script in the InspIRCd base directory and not the binary in bin/ (or wherever you told configure to install the binaries to) See the page on Commandline Parameters for more details on how you can use the script.
It is easiest to do all configuration as compiling the non-priveleged user that InspIRCd will run as. root access is not needed for any part of the configuration and building (unless you install it to a priveleged directory, but don't do that).
If you want to add a module which you did not install to start with then copy or link the module's .cpp to src/modules, then run:
If you have libraries installed in non-standard places, such as a local install of libgnutls in your home directory then you need the path to the binaries of your local install in your $PATH variable. You can (temporarily) add a path to $PATH by running:
And then running configure and make as normal, to make the path changes permenant you need to put the PATH definiton into your shell's startup script.