{"id":205,"date":"2023-02-12T13:44:36","date_gmt":"2023-02-12T13:44:36","guid":{"rendered":"https:\/\/tutorials.darkworld.network\/?p=205"},"modified":"2023-02-12T13:44:36","modified_gmt":"2023-02-12T13:44:36","slug":"unrealircd-installation-and-configuration","status":"publish","type":"post","link":"https:\/\/tutorials.darkworld.network\/?p=205","title":{"rendered":"UnrealIRCd Installation and Configuration"},"content":{"rendered":"<p>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.<\/p>\n<h1><span id=\"Prerequisites\" class=\"mw-headline\">Prerequisites<\/span><\/h1>\n<p>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.<\/p>\n<ul>\n<li>Ubuntu 20.*\/21.*\/22.*:\u00a0<code>sudo apt-get install build-essential pkg-config gdb libssl-dev libpcre2-dev libargon2-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev<\/code><\/li>\n<li>Ubuntu 18.*:\u00a0<code>sudo apt-get install build-essential pkg-config gdb libssl-dev libpcre2-dev libargon2-0-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev<\/code><\/li>\n<li>Ubuntu 16.*:\u00a0<code>sudo apt-get install build-essential pkg-config gdb libssl-dev libpcre2-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev<\/code><\/li>\n<li>Debian 9\/10:\u00a0<code>sudo apt-get install build-essential pkg-config gdb libssl-dev libpcre2-dev libargon2-0-dev libsodium-dev libc-ares-dev libcurl4-openssl-dev<\/code><\/li>\n<li>For unlisted Linux distro&#8217;s which use apt-get, the minimum requirement is:\u00a0<code>sudo apt-get install build-essential libssl-dev<\/code><\/li>\n<li>For Linux distro&#8217;s that use yum: you need a compiler and the openssl-dev\/openssl-devel\/libssl-dev package.<\/li>\n<li>For FreeBSD: your system normally already has a compiler and the openssl development library installed, so you are good to go.<\/li>\n<\/ul>\n<p>If, for some reason, you are curious what libraries UnrealIRCd uses or can use, then see\u00a0<a title=\"Libraries used by UnrealIRCd\" href=\"https:\/\/www.unrealircd.org\/docs\/Libraries_used_by_UnrealIRCd\">Libraries used by UnrealIRCd<\/a>.<\/p>\n<h1><span id=\"Grab_the_source_.28.tar.gz.29\" class=\"mw-headline\">Grab the source (.tar.gz)<\/span><\/h1>\n<h2><span id=\"From_the_shell\" class=\"mw-headline\">From the shell<\/span><\/h2>\n<p>Connect to the *NIX server via SSH. All the following commands execute on the *NIX server.<\/p>\n<pre>wget --trust-server-names https:\/\/www.unrealircd.org\/downloads\/unrealircd-latest.tar.gz<\/pre>\n<p>On FreeBSD you may have to use:<\/p>\n<pre>fetch https:\/\/www.unrealircd.org\/downloads\/unrealircd-latest.tar.gz<\/pre>\n<p>If neither works, for example you get an &#8216;unknown command&#8217; then you should install the &#8216;wget&#8217; package on your system or try uploading (see next).<\/p>\n<h2><span id=\"Alternative:_uploading_to_shell\" class=\"mw-headline\">Alternative: uploading to shell<\/span><\/h2>\n<p>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.<\/p>\n<h1><span id=\"Extract_the_source\" class=\"mw-headline\">Extract the source<\/span><\/h1>\n<p>Extract the .tar.gz and enter the unrealircd-x.y.z directory:<\/p>\n<pre>tar xzvf unrealircd-6.0.X.tar.gz\r\ncd unrealircd-6.0.X\r\n<\/pre>\n<p>Replace the\u00a0<code>6.0.X<\/code>\u00a0with the actual version number!<\/p>\n<p>NOTE: There&#8217;s some logic here. If the file is called, say,\u00a0<code>unrealircd-6.0.0.tar.gz<\/code>\u00a0then it will extract to the\u00a0<code>unrealircd-6.0.0\/<\/code>\u00a0directory. The he directory name is different for each release to make sure you don&#8217;t accidentally overwrite your existing installation.<\/p>\n<h1><span id=\"Compiling\" class=\"mw-headline\">Compiling<\/span><\/h1>\n<p>First, run the\u00a0<b>.\/Config<\/b>\u00a0script which will ask a number of questions. You can just press Enter to accept the default answers.<\/p>\n<pre>.\/Config\r\n<\/pre>\n<p>Now, compile UnrealIRCd by running\u00a0<b>make<\/b>, this may take a minute (or two):<\/p>\n<pre>make\r\n<\/pre>\n<p>Finally, run\u00a0<b>make install<\/b>\u00a0(important!):<\/p>\n<pre>make install\r\n<\/pre>\n<h1><span id=\"Creating_a_configuration_file\" class=\"mw-headline\">Creating a configuration file<\/span><\/h1>\n<p>UnrealIRCd needs a configuration file. Don&#8217;t worry, you don&#8217;t have to create this file from scratch. We ship with an example configuration file that you have to walk through and tweak at a few places:<\/p>\n<ol>\n<li>Change to the installed UnrealIRCd directory, this is\u00a0<i>\/home\/yourusername\/unrealircd<\/i>\u00a0by default (For more information on the directory structure see\u00a0<a title=\"UnrealIRCd files and directories\" href=\"https:\/\/www.unrealircd.org\/docs\/UnrealIRCd_files_and_directories\">UnrealIRCd files and directories<\/a>).\n<pre>cd ~\/unrealircd<\/pre>\n<\/li>\n<li>Copy conf\/example\/example.conf to your conf\/ directory and rename it to\u00a0<b>unrealircd.conf<\/b>\n<pre>cp conf\/examples\/example.conf conf\/unrealircd.conf<\/pre>\n<p>TIP: Is your native language\u00a0<u>not English<\/u>? Then check the conf\/examples directory. We ship with several example configuration files in different languages. If you want to use one of those, simply copy that one instead.<\/li>\n<li>Open the file with an editor (eg:\u00a0<b>nano conf\/unrealircd.conf<\/b>)<\/li>\n<li><b>Read the\u00a0<a title=\"Configuration file syntax\" href=\"https:\/\/www.unrealircd.org\/docs\/Configuration_file_syntax\">Configuration file syntax<\/a>\u00a0article<\/b>. It will only take a few minutes and will save you a lot of trouble in next step(s)!<\/li>\n<li>Walk through the unrealircd.conf block by block \/ line by line and edit the settings to suit your needs. This takes 10 &#8211; 20 minutes.<br \/>\n<u>DO NOT RUSH THIS<\/u>\u00a0because you NEED to change some values, otherwise the server will refuse to start!<\/li>\n<li>Boot UnrealIRCd by running\u00a0<b>.\/unrealircd start<\/b>\u00a0from your ~\/unrealircd directory.<\/li>\n<li>Errors while trying to start UnrealIRCd?\n<ul>\n<li>Did you really go through the config file from top to bottom? You need to, because some values MUST be changed.<\/li>\n<li>Read the error on your screen and edit your unrealircd.conf to fix the error, then try starting UnrealIRCd again.<\/li>\n<li>See the\u00a0<a title=\"FAQ\" href=\"https:\/\/www.unrealircd.org\/docs\/FAQ\">FAQ<\/a>\u00a0for common configuration mistakes!<\/li>\n<\/ul>\n<\/li>\n<li>Up and running? Connect with an IRC client to your server and have fun. See next section too.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>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. Prerequisites At a minimum, UnrealIRCd needs a compiler and the OpenSSL library. Even better is if you install a few other libraries, but this<br \/><a class=\"moretag\" href=\"https:\/\/tutorials.darkworld.network\/?p=205\">+ Read More<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-205","post","type-post","status-publish","format-standard","hentry","category-linux"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=\/wp\/v2\/posts\/205","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=205"}],"version-history":[{"count":1,"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=\/wp\/v2\/posts\/205\/revisions"}],"predecessor-version":[{"id":206,"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=\/wp\/v2\/posts\/205\/revisions\/206"}],"wp:attachment":[{"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=205"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=205"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tutorials.darkworld.network\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=205"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}