/unrealircd

Official UnrealIRCd repository. Note that by default you will be on the UnrealIRCd 4 (Release Candidate) branch. For 3.2.x (stable) use the 'master' branch instead or use the official downloads from our site

Primary LanguageCGNU General Public License v2.0GPL-2.0

About UnrealIRCd

UnrealIRCd is an Open Source IRC Server, serving thousands of networks since 1999. It runs on Linux, OS X and Windows and is currently the most widely deployed IRCd with a market share of over 50%. UnrealIRCd is a highly advanced IRCd with a strong focus on modularity, an advanced and highly configurable configuration file. Key features include SSL, cloaking, its advanced anti-flood and anti-spam systems, swear filtering and module support. We are also particularly proud on our extensive online documentation.

Pick the right branch!

UnrealIRCd 4 is currently in Release Candidate stage and will soon be the next major version of UnrealIRCd. The plan is to release UnrealIRCd 4 in Q4 2015. This is the 'unreal40' branch and is the default branch on GitHub.

The alternative are the 3.2.x (stable) series which have proven to be very reliable over the past 10 years. If you want to run a really stable IRCd then download UnrealIRCd 3.2 from www.unrealircd.org, or use the 'master' branch on GitHub (NOTE: this is not the default branch!).

How to get started

Please consult our excelent online documentation at https://www.unrealircd.org/docs/ when setting up the IRCd!

Note: the procedure below is for UnrealIRCd 4 (not 3.2.x!)

Step 1: Installation

Windows

Simply download the UnrealIRCd Windows version from www.unrealircd.org

Compiling UnrealIRCd for Windows yourself is not straightforward and thus not recommended.

*BSD/Linux/OS X

First you must compile the IRCd:

  • Run ./Config
  • Run make
  • Run make install
  • Now change to the directory where you installed UnrealIRCd, e.g. cd /home/xxxx/unrealircd

Step 2: Configuration

Configuration files are stored in the conf/ folder by default (eg: /home/xxxx/unrealircd/conf)

Create a configuration file

If you are new, then you need to create your own configuration file: Copy conf/examples/example.conf to conf/ and call it unrealircd.conf. Then open it in an editor and carefully modify it using the documentation and FAQ as a guide (see below).

Step 3: Booting

Linux/*BSD/OS X

Run ./unrealircd start in the directory where you installed UnrealIRCd.

Windows

Start -> All Programs -> UnrealIRCd -> UnrealIRCd

Documentation & FAQ

You can find the documentation online at: http://www.unrealircd.org/docs/

We also have a good FAQ: http://www.unrealircd.org/docs/FAQ

Website, support, and other links