User Tools

Site Tools


installing_irc_at_home

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
installing_irc_at_home [2020/07/04 01:28] – [inspircd.conf] waxphilosophicinstalling_irc_at_home [2020/07/13 01:01] (current) waxphilosophic
Line 7: Line 7:
 This how-to covers installing and IRC server and clients for a typical home LAN. The hardware and OS used is a Raspberry Pi 2 with FreeBSD 12.1, but any system with a recent BSD variant should work with little need or no modification. This how-to covers installing and IRC server and clients for a typical home LAN. The hardware and OS used is a Raspberry Pi 2 with FreeBSD 12.1, but any system with a recent BSD variant should work with little need or no modification.
  
-At the time of writing, the SDF servers run InspIRCd for the server side and ircII for the default client. The same software is used in this document. In addition, this how-to covers Pidgin, a Windows/Mac GUI client that can be used for IRC as well as other instant messaging protocols.+At the time of writing, the SDF servers run InspIRCd for the server side and ircII for the default client. The same software is used in this document. In addition, this how-to covers Pidgin, a Windows/Mac GUI client that can be used for IRC as well as other instant messaging protocols. Mozilla Thunderbird has IRC capabilities and is covered as well.
  
 ===== Installing Server-Side Software ===== ===== Installing Server-Side Software =====
Line 77: Line 77:
 === CONNECTIONS CONFIGURATION === === CONNECTIONS CONFIGURATION ===
  
-After commenting out the last two lines of PORT CONFIGURATION, so we can move on to CONNECTIONS CONFIGURATION. The changes here involve changing resolvehostnames="yes" to resolvehostnames="no".+After commenting out the last two lines of PORT CONFIGURATION, so we can move on to CONNECTIONS CONFIGURATION. The changes here involve changing resolvehostnames="yes" to resolvehostnames="no" and changing the IP address range in an example section.
  
-The reason for this is entirely because of DNS. Unless you are running a robust DNS infrastructure on your LAN, chances are good that your ISP's router (the typical home LAN DNS server) will not do reverse look-ups. Setting resolvehostnames="no" will instruct InspIRCd to not even try, sparing you countless warning messages.+The reason for changing resolvehostnames is entirely because of DNS as you might have guessed. Unless you are running a robust DNS infrastructure on your LAN, chances are good that your ISP's router (the typical home LAN DNS server) will not do reverse look-ups. Setting resolvehostnames="no" will instruct InspIRCd to not even try, sparing you countless warning messages.
  
 If you have a more robust DNS server on your network, you can certainly leave this as-is. If you see errors like "Could not resolve your hostname: Malformed answer" when logging in, it means the reverse lookups are not working. If you have a more robust DNS server on your network, you can certainly leave this as-is. If you see errors like "Could not resolve your hostname: Malformed answer" when logging in, it means the reverse lookups are not working.
Line 90: Line 90:
  
 Do not give into the temptation to comment the lines out. This is not the same as setting it to no. Do not give into the temptation to comment the lines out. This is not the same as setting it to no.
 +
 +As for the IP address range that needs changing, this is in the example <connect:allow> class. There is a sample IP range of 203.0.113.* being allowed. This section should be deleted or at least have the IP range changed to your home LAN's range of addresses. Typical home setups use 192.168.0.* and that is what is shown here.
 +
 +<code>
 +allow="192.168.0.*"
 +</code>
  
 === Enabling Server Operators === === Enabling Server Operators ===
Line 186: Line 192:
 What you see under the headings of CLASS CONFIGURATION and OPERATOR COMPOSITION can be left as default. It's the OPERATOR CONFIGURATION section we're interested in. What you see under the headings of CLASS CONFIGURATION and OPERATOR COMPOSITION can be left as default. It's the OPERATOR CONFIGURATION section we're interested in.
  
-There are a couple examples given using the names Attila and Brian. Look them over to read the comments and then delete them. Yes, delete. Delete everything after the section heading.+There are a couple examples given using the names Attila and Brain. Look them over to read the comments and then delete them. Yes, delete. Delete everything after the section heading.
  
 When you're done, the opers.conf file should end here: When you're done, the opers.conf file should end here:
Line 231: Line 237:
 It would also be difficult to enforce in an environment were there are no reverse DNS lookups and IPs are handed out from a DHCP server. In other words, neither user@hostname nor user@192.168.x.x would work reliably. "user@*" could be used to give only one account the admin ability. On a home LAN, this is the best we can do.  It would also be difficult to enforce in an environment were there are no reverse DNS lookups and IPs are handed out from a DHCP server. In other words, neither user@hostname nor user@192.168.x.x would work reliably. "user@*" could be used to give only one account the admin ability. On a home LAN, this is the best we can do. 
  
-Other than changing the lame password, that'it for opers.conf.+Other than changing the lame password, there'one more step for opers.conf, and that is to change the vhost under the OPERATOR COMPOSITION section. This is purely cosmetic, but it helps show that we pay attention to details. 
 + 
 +Right around line 75 of opers.conf, you'll see: 
 + 
 +<code> 
 +vhost="netadmin.omega.example.org" 
 +</code> 
 + 
 +Following the naming used in the example, change this to: 
 + 
 +<code> 
 +vhost="netadmin.beastie.home.lan" 
 +</code> 
 + 
 +If you have customized the domain names to something else, by all means use that.
  
 ==== motd.txt ==== ==== motd.txt ====
Line 372: Line 392:
 > #<bind address="" port="7000,7001" type="servers"> > #<bind address="" port="7000,7001" type="servers">
 > #<bind address="1.2.3.4" port="7005" type="servers" ssl="openssl"> > #<bind address="1.2.3.4" port="7005" type="servers" ssl="openssl">
 +278c278
 +<          allow="203.0.113.*"
 +---
 +>          allow="192.168.0.*"
 313c313 313c313
 <          resolvehostnames="yes" <          resolvehostnames="yes"
Line 411: Line 435:
 ==== opers.conf ==== ==== opers.conf ====
  
-opers.conf is not included since most of the changes involved deleting the bottom third of the file.+This is an abreviated diff of opers.conf since most of the changes involved deleting the bottom third of the file. 
 + 
 +<code> 
 +75c75 
 +<     vhost="netadmin.omega.example.org" 
 +--- 
 +>     vhost="netadmin.beastie2.home.lan" 
 +94,95d93 
 +
 +< # Operator account with a plaintext password. 
 +97,99c95,99 
 +<       # name: Oper login that is used to oper up (/OPER <username> <password>). 
 +<       # Remember: This is case sensitive. 
 +<       name="Attila" 
 +--- 
 +>     name="beastie" 
 +>     hash="sha256" 
 +>     password="1ec1c26b50d5d3c58d9583181af8076655fe00756bf7285940ba3670f99fcba0" 
 +>     host="*@*" 
 +>     type="NetAdmin"> 
 +101,181d100 
 +[Not shown for brevity.] 
 +</code>
  
 ==== motd.txt ==== ==== motd.txt ====
Line 426: Line 472:
  
   * Choose a protocol of IRC.   * Choose a protocol of IRC.
-  * Fill in the loginserver, and password with the information you use to log into the FreeBSD server+  * Fill in the login and server that you use on your LAN
-  * Check the remember password if you likebut be aware that it is saved in clear text in the %APPDATA% directory.+  * Password is not required for IRCand be aware that it is saved in clear text in the %APPDATA% directory if you use it.
   * The remaining tabs may be left with default settings.   * The remaining tabs may be left with default settings.
  
Line 441: Line 487:
  
 See this WikiHow article for a guided step-by-step with pictures: [[ https://www.wikihow.com/Automatically-Join-an-IRC-Channel-in-Pidgin ]] See this WikiHow article for a guided step-by-step with pictures: [[ https://www.wikihow.com/Automatically-Join-an-IRC-Channel-in-Pidgin ]]
 +
 +===== Thunderbird for GUI clients =====
 +
 +In addition to email, Thunderbird also has IRC capabilities. To access, find Chat on the toolbar. It's after Get Messages and Write. Click Chat.
 +
 +Unless you've set up Thunderbird as a chat client previously, you'll be looking at a message that say you haven't set up any chat accounts, and a button labeled Get Started. Click on Get Started.
 +
 +Follow the set-up wizard.
 +
 +  * Select IRC as the network.
 +  * Enter your nickname and IRC server hostname (beastie.home.lan if you're following the example.)
 +  * You can leave the password blank.
 +  * Change the port to 6667 in the Advanced Options.
 +  * Remove the check for Use SSL in the Advanced Options.
 +
 +Leave the box checked for connect Connect to This Account Now to test.
  
 ====== Go Forth and Conquer ====== ====== Go Forth and Conquer ======
installing_irc_at_home.1593826116.txt.gz · Last modified: 2020/07/04 01:28 by waxphilosophic