Skip to content

anope/anope

Repository files navigation

About

Anope is an open source set of IRC services. It is highly modular, with a vast number of configurable parameters, and is the most used IRC services package. There are also many modules on the modsite to add additional features. It runs on Linux, BSD, and Windows, and supports many modern IRCds, including InspIRCd, UnrealIRCd, and ircd-hybrid. For more details, credits, command line options, and contact information see docs/README.

Installation

Linux/BSD

Download the latest release off of the releases page.

$ ./Config
$ cd build
$ make
$ make install

Now change to the directory where you installed Anope to, e.g. $ cd ~/anope/

Windows

Download the latest release off of the releases page and run the installer.

Configuration

Copy conf/anope.example.conf to conf/anope.conf

$ cp conf/anope.example.conf conf/anope.conf

Edit anope.conf, configuring the uplink, serverinfo, and protocol module configurations. Example link blocks for popular IRCds are included in the the example.conf documentation. The Anope wiki is also a good source of information. Our support channel is located at #anope on irc.teranova.net.

Note that the example configuration file includes other example configuration files. If you want to modify the other example configuration files, copy them (e.g. modules.example.conf to modules.conf) and modify the include directive in anope.conf to include the new file.

Running

Run $ ./bin/anope to start Anope. If asked to provide logs for support, use the --support flag, e.g.: $ ./bin/anope --support

Installing extra modules

Extra modules, which are usually modules which require extra libraries to use, such as m_mysql, can be enabled with the ./extras command from the source directory. Then re-run Config, make and make install again. Third party modules can be installed by placing them into the modules/third directory.