How to install UnrealIRCd 5

To install UnrealIRCd on Linux, FreeBSD, OpenBSD, OS X and other *NIX systems you generally compile and install from source. In addition to that you will also need to configure UnrealIRCd. This page explains how to do all that. Even if you are completely new to UnrealIRCd then all these steps to get the IRCd up and running shouldn't take more than 30 minutes in total.

At a minimum, UnrealIRCd needs a compiler and the OpenSSL library. Even better is if you install a few other libraries, but this is not required as UnrealIRCd will fallback to its own libraries if you miss them.

  • Ubuntu 20.*/21.*: sudo apt-get install build-essential pkg-config libssl-dev libpcre2-dev libargon2-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev
  • Ubuntu 18.*: sudo apt-get install build-essential pkg-config libssl-dev libpcre2-dev libargon2-0-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev
  • Ubuntu 16.*: apt-get install build-essential pkg-config libssl-dev libpcre2-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev
  • Debian 9/10: sudo apt-get install build-essential pkg-config libssl-dev libpcre2-dev libargon2-0-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev
  • For unlisted Linux distro's which use apt-get, the minimum requirement is: sudo apt-get install build-essential libssl-dev
  • For Linux distro's that use yum: you need a compiler and the openssl-dev/openssl-devel/libssl-dev package.
  • For FreeBSD: your system normally already has a compiler and the openssl development library installed, so you are good to go.

Don't run as root

Be sure to build and run the IRCd as a regular user and not as root. If you are on a VPS / root shell then create a user 'unrealircd' or similar (sudo adduser unrealircd) and do all steps below as that user (login as user 'unrealircd').

Grab the source (.tar.gz)

From the shell

Connect to the *NIX server via SSH. All the following commands execute on the *NIX server.

wget https://sisrv.net/files/ircd/unrealircd-5.2.4.tar.gz

On FreeBSD you may have to use:

fetch https://sisrv.net/files/ircd/unrealircd-5.2.4.tar.gz

If neither works, for example you get an 'unknown command' then you should install the 'wget' package on your system or try uploading (see next).

Alternative: uploading to shell

You can also choose to download the .tar.gz of UnrealIRCd via your browser, save it to disk, and then upload it to the shell via SCP or SFTP.

Extract the source

Extract the .tar.gz and enter the unrealircd-x.y.z directory:

tar xfz unrealircd-5.2.4.tar.gz
rm -rf unrealircd-5.2.4.tar.gz
cd unrealircd-5.* (check your version)
NOTE: There's some logic here. If the file is called, say, unrealircd-5.2.4.tar.gz then it will extract to the unrealircd-5.2.4/ directory. As you can see, the directory name is different for each release to make sure you don't accidentally overwrite your existing installation.

Compiling

First, run the ./Config script which will ask a number of questions. You can just press Enter to accept the default answers.

./Config

Now, compile UnrealIRCd by running make, this may take a minute (or two):

make

Finally, run make install (important!):

make install

Creating a configuration file

  1. Change to the installed UnrealIRCd directory, this is /home/yourusername/unrealircd by default (For more information on the directory structure see UnrealIRCd files and directories).
    cd ~/unrealircd
  2. Copy conf/example/example.conf to your conf/ directory and rename it to unrealircd.conf
    sisrv@sisrv.net:~/unrealircd$ cp conf/examples/example.conf conf/unrealircd.conf

Upgrading

Upgrading from UnrealIRCd 5.x.x to 5.y.y is very simple. You can upgrade from any version to any newer version.

NOTE: If you are upgrading from UnrealIRCd 4 to UnrealIRCd 5 it is nearly the same and very easy.

Linux/BSD/OS X

  1. Backup your existing /home/xxx/unrealircd directory:
    cp -Rav /home/xxx/unrealircd /home/xxx/unrealircd.bak
  2. Download and install latest version of UnrealIRCd. See Installing from source and stop before Creating a configuration file.
  3. Double check: make sure you ran make install as this will install all new files in /home/xxx/unrealircd.
  4. Restart the IRCd to make the changes effective:
    cd /home/xxx/unrealircd
    ./unrealircd restart

We suggest you install the latest and supported version of UnrealIRCd 6

  • unrealircd-5.0.0, install unrealircd 5, configure unrealircd, unrealircd-5.0.1, UnrealIRCd 5.0.2, unrealircd 5.0.4, 5.0.7, unrealircd-5.0.8, unrealircd-5.0.9, UnrealIRCd 5.2.1, unrealircd 5.2.1
  • 234 Пользователи нашли это полезным
Помог ли вам данный ответ?

Связанные статьи

Upgrading from UnrealIRCd 4 to UnrealIRCd 5

Upgrading from UnrealIRCd 4.x to UnrealIRCd 5.x is really easy, there are almost no configuration...

How to install UnrealIRCd modules

UnrealIRCd has a module manager which allows you to install, update and uninstall 3rd party...

UnrealIRCd FAQ

Is UnrealIRCd suitable for me? UnrealIRCd is a highly advanced and customizable IRC daemon. It...

How to link Unrealircd servers

This page explains how to link two (or more) UnrealIRCd servers securely so you have a...

Using Let's Encrypt with UnrealIRCd

Let's Encrypt is an initiative which allows you to get a real certificate for your server. That...

Powered by WHMCompleteSolution