1,575
edits
Changes
no edit summary
#run ''sudo adduser ircd'' to create the UnrealIRCd's user
#run ''sudo adduser ircd sudo'' to add the ''ircd'' user to the ''sudo'' group (we'll remove this privilege at the end)
#run ''su ircd'' to switch to the ''ircd'' for most of the remainder of the install
#run ''sudo apt install wget make gcc build-essential openssl libcurl4-openssl-dev zlib1g zlib1g-dev zlibc libgcrypt20 libgcrypt20-dev libssl-dev'' to install necessary dependencies
=Install UnrealIRCd=
#run ''cd ~'' to move to the home directory (where we'll install this software)
#run ''wget --no-check-certificate --trust-server-names https://www.unrealircd.org/downloads/unrealircd-latest.tar.gz'' to download the latest installer package
#run ''tar xzvf unrealircd-*.tar.gz'' to uncompress the downloaded package
#run ''cd unrealirc-4.2.3'' (replace 4.2.3 with the version you download)
#run ''./Config''
##press '''[Enter]''' throughout the entire Config process to accept their defaults until you get to the question "Do you want to generate an SSL certificate for the IRCd? Only answer No if you already have one."
##*press '''[Enter]''' to generate an SSL key if you're going to setup a local server that isn't visible to the wider internet. Then fill out the questions on What/Where for the SSL certificate (these values don't have to be anything specific).
##*If you are going to make this server available to the wider internet you'll want an official SSL certificate that people trust. In this case type ''No''. For the trusted certificate you should use something like [https://letsencrypt.org/ LetsEncypt]. Right now I don't have instructions on that part but hopefully I'll get this updated soon.
#once the Config process is complete and you're back at the command prompt run ''make''
#run ''make install''
#run ''cd ..''
#run ''rm unrealircd-*.tar.gz'' to remove the compressed package you downloaded
#run ''sudo rm -r unrealircd-*'' to remove the uncompressed package you downloaded
=Configure UnrealIRCd=
#run ''cp ~/unrealircd/conf/examples/example.conf ~/unrealircd/conf/unrealircd.conf''
#run ''/home/ircd/unrealircd/unrealircd gencloak'' and copy the resultant 3 lines for use later
#run ''nano ~/unrealircd/conf/unrealircd.conf'' to edit the default config file
##comment out ''include "badwords.conf";''
##uncomment ''include "spamfilter.conf";''
##find the ''"me {"'' block
###change name to ''"myserver.com"''
###change info to ''"My Server!"''
##find the ''"admin {"'' block
###change the 3 lines to match your
####name
####username
####email address
##find the first ''"allow {"'' block
###add a line ''password "MyPassword";''
###change ''maxperip'' to ''100;''
##find the second ''"allow {"'' block and delete it or comment it out
##find the ''"oper bobsmith {"'' block
###change ''"bobsmith"'' to your username
###change the password to your password
##find the ''"lin hub.mynet.org"'' block and delete it or comment it out
##find the ''"link services.mynet.org"'' and delete it or comment it out
##find the ''"ulines {"'' block and delete it or comment it out
##find the ''"drpass {"'' block and optionally change the passwords
##find the ''"ban ip {"'' block and delete or comment it out
##find the ''"ban server {"'' block and delete it or comment it out
##find the ''"ban user {"'' block and delete it or comment it out
##find the ''"ban realname {"'' blocks and delete them or comment them out
##find the ''"except ban {"'' block and enter your own ip or server address
##find the ''"except tkl {"'' block and enter your own ip or server address
##find the ''"deny dcc {"'' block and delete it or comment it out
##find the ''"deny channel {"'' block and delete it or comment it out
##find the ''"vhost {"'' block and delete it or comment it out
##find the ''"blacklist dronebl {"'' block and delete it or comment it out
##find the ''"blackist efnetrbl {"'' block and delete it or comment it out
##find the ''"/* Network configuration */ set {"'' block
###change ''network-name'' "MyIRCNet"
###change ''default-server'' "myserver.net"
###change ''services-server'' "myserver.net"
###change ''stats-server'' "myserver.net"
###in the ''"cloak-keys {"'' block change the 3 lines to the 3 lines your copied from the ''unrealircd gencloak'' command above
##find the ''"/* Server specific configuration */ set {"'' block
###change ''kline-address'' to your admin email
##hit '''Ctrl-X''' and then '''Y''' to save and quit nano
#create a Message Of The Day
##run ''touch ircd.motd''
##run ''chmod 600 ircd.motd''
##run ''nano ircd.motd'' and enter a suitable motd like "Welcome to my IRC server!"
#create, and enable, an IRCd service
##run ''nano /home/ircd/unrealircd/ircd.service'' and fill the file with the following
##*[Unit]
##*Description=UnrealIRCd IRC Daemon Service
##*After=network.target
##*
##*[Service]
##*User=ircd
##*Group=ircd
##*Type=forki##*ng
##*ExecStart=/home/ircd/unrealircd/unrealircd start
##*ExecStop=/home/ircd/unrealircd/unrealircd stop
##*ExecReload=/home/ircd/unrealircd/unrealircd restart
##*
##*[Install]
##*WantedBy=multi-user.target
##run ''ln -s /home/ircd/unrealircd/ircd.service /etc/systemd/system/ircd.service''
##run ''sudo systemctl enable ircd'' to have UnrealIRCd start on boot
##run ''sudo systemctl start ircd'' to enable UnrealIRCd
##run ''exit'' to return to your original sudo user
##run ''sudo gpasswd -d ircd sudo'' to remove the ''ircd'' user from the ''sudo'' group
Now you can go connect to your irc server with something like [https://hexchat.github.io/ HexChat].