Difference between revisions of "UnrealIRCd"

From ArchWiki
Jump to: navigation, search
m (UnrealIRCd now looks for ssl keys in /etc/unrealircd/ssl folder by default)
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:Daemons and system services]]
+
[[Category:Internet Relay Chat]]
'''UnrealIRCd''' (Unreal IRC daemon) is an Open Source IRC Server. Development of UnrealIRCd began in May of 1999. Unreal was created from the Dreamforge IRCd that was formerly used by the DALnet IRC Network. Over the years, many new and exciting features have been added to Unreal. It is hard to even see a resemblance between the current Unreal and Dreamforge.
+
'''[https://www.unrealircd.org/ UnrealIRCd]''' (Unreal IRC daemon) is an Open Source IRC Server. Development of UnrealIRCd began in May of 1999. Unreal was created from the Dreamforge IRCd that was formerly used by the DALnet IRC Network. Over the years, many new and exciting features have been added to Unreal. It is hard to even see a resemblance between the current Unreal and Dreamforge.
  
 
== Installing UnrealIRCd ==
 
== Installing UnrealIRCd ==
  
Install from the community repo:
+
[[Install]] the {{Pkg|unrealircd}} package.
 
+
pacman -S unrealircd
+
  
 
== Configuring (mandatory) ==
 
== Configuring (mandatory) ==
Line 12: Line 10:
 
Many of the settings you'll want to set are very dependent on how you will use your IRC server. There is a default configuration but it doesn't work out of the box.
 
Many of the settings you'll want to set are very dependent on how you will use your IRC server. There is a default configuration but it doesn't work out of the box.
  
The files in '''/etc/unrealircd/''' are not viewable by users, only root can see/read/edit the files in this directory.
+
From there you'll want to follow the [https://www.unrealircd.org/files/docs/unreal32docs.html#configuringyourunrealircdconf UnrealIRCd Configuration Docs] making sure to configure all of the required fields such as {{ic|me}}, {{ic|admin}}, {{ic|class}}, etc.
  
The first thing you'll want to do when setting up UnrealIRCd is to open /etc/unrealircd/unrealircd.conf and find the lines where it says '''FOR *NIX, uncomment the following 2lines''' and uncomment them. You'll also need to remove the '''src/''' from the start of the path, as they are in the '''modules''' directory under '''/etc/unrealircd/'''
+
Place your SSL key/cert at {{ic|/etc/unrealircd/ssl/server.key.pem}} and {{ic|/etc/unrealircd/ssl/server.cert.pem}}. If you do not have a proper certificate, you can generate a self-signed one, as explained at [[Apache HTTP Server#TLS/SSL]]. (note that the files have to be named slightly different for UnrealIRCd)
 
+
From there you'll want to follow the [http://www.unrealircd.com/files/docs/unreal32docs.html#configuringyourunrealircdconf UnrealIRCd Configuration Docs] making sure to configure all of the required fields such as '''me''', '''admin''', '''class''' etc etc.
+
 
+
As far as I could tell, you do not get even snake oil certs with the UnrealIRCd package. I am sure there are other (easier) ways to generate the certs, but my solution was to use [[ABS]] to build the package, then went into '''src/''' and ran:
+
 
+
make pem
+
 
+
Which will ask you a series of questions, if you are running a public facing server you should answer them honestly, if you are not, then the answers do not really matter.
+
  
 
== Starting/Stopping the daemon ==
 
== Starting/Stopping the daemon ==
  
You can start and stop the UnrealIRCd daemon as usual by running:
+
You can [[start]] and [[stop]] the UnrealIRCd daemon with the {{ic|unrealircd.service}} systemd unit.
 
+
sudo /etc/rc.d/unrealircd {start|stop|restart}
+
  
If you run into problems where the daemon won't start, I recommend running:
+
If you run into problems where the daemon will not start, try running:
  
  sudo unrealircd
+
  # unrealircd
  
It will spew out the errors and what line they occur on. Often it is due to problems in your configuration.
+
It will print out the errors and what line they occur on. Often errors are due to problems in your configuration.

Latest revision as of 18:49, 14 October 2016

UnrealIRCd (Unreal IRC daemon) is an Open Source IRC Server. Development of UnrealIRCd began in May of 1999. Unreal was created from the Dreamforge IRCd that was formerly used by the DALnet IRC Network. Over the years, many new and exciting features have been added to Unreal. It is hard to even see a resemblance between the current Unreal and Dreamforge.

Installing UnrealIRCd

Install the unrealircd package.

Configuring (mandatory)

Many of the settings you'll want to set are very dependent on how you will use your IRC server. There is a default configuration but it doesn't work out of the box.

From there you'll want to follow the UnrealIRCd Configuration Docs making sure to configure all of the required fields such as me, admin, class, etc.

Place your SSL key/cert at /etc/unrealircd/ssl/server.key.pem and /etc/unrealircd/ssl/server.cert.pem. If you do not have a proper certificate, you can generate a self-signed one, as explained at Apache HTTP Server#TLS/SSL. (note that the files have to be named slightly different for UnrealIRCd)

Starting/Stopping the daemon

You can start and stop the UnrealIRCd daemon with the unrealircd.service systemd unit.

If you run into problems where the daemon will not start, try running:

# unrealircd

It will print out the errors and what line they occur on. Often errors are due to problems in your configuration.