installing_irc_at_home
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| installing_irc_at_home [2020/07/11 16:24] – [opers.conf] vhost addition waxphilosophic | installing_irc_at_home [2024/09/05 00:05] (current) – ie” hc9 | ||
|---|---|---|---|
| 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 34: | Line 34: | ||
| === SERVER DESCRIPTION === | === SERVER DESCRIPTION === | ||
| - | Start with the section entitled SERVER DESCRIPTION. Here you will find the server configuration spread out over several lines and interspersed with comments. For the examples in this document, I am naming the server | + | Start with the section entitled SERVER DESCRIPTION. Here you will find the server configuration spread out over several lines and interspersed with comments. For the examples in this document, I am naming the server |
| < | < | ||
| Line 77: | Line 77: | ||
| === CONNECTIONS CONFIGURATION === | === CONNECTIONS CONFIGURATION === | ||
| - | After commenting out the last two lines of PORT CONFIGURATION, | + | After commenting out the last two lines of PORT CONFIGURATION, |
| - | 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=" | + | The reason for changing resolvehostnames |
| - | 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" | + | If you have a more robust DNS server on your network, you can certainly leave this as-is. If you see errors like “'' |
| - | There are two resolvehostnames=" | + | There are two '' |
| < | < | ||
| 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 < | ||
| + | |||
| + | < | ||
| + | allow=" | ||
| + | </ | ||
| === Enabling Server Operators === | === Enabling Server Operators === | ||
| Line 99: | Line 105: | ||
| </ | </ | ||
| - | It needs to be uncommented if you want to enable users to gain administrative privileges. If you don't remove the leading hash, any attempt to use the /OPER command will result in the message | + | It needs to be uncommented if you want to enable users to gain administrative privileges. If you don't remove the leading hash, any attempt to use the /OPER command will result in the message |
| It should look like this when you're done: | It should look like this when you're done: | ||
| Line 127: | Line 133: | ||
| The next section to need editing is MODULES. You will have scrolled by quite a few sections to get there. | The next section to need editing is MODULES. You will have scrolled by quite a few sections to get there. | ||
| - | There is only one change to be made in the MODULES section and that is to uncomment the line that reads: #< | + | There is only one change to be made in the MODULES section and that is to uncomment the line that reads: |
| It should look like this when you're done: | It should look like this when you're done: | ||
| Line 143: | Line 149: | ||
| After including modules.conf inside of inspircd.conf, | After including modules.conf inside of inspircd.conf, | ||
| - | But, while we're editing, there are two more handy modules to enable. Those are "sha256" | + | But, while we're editing, there are two more handy modules to enable. Those are “sha256” and “password_hash” and are used for avoiding plain-text passwords. All of this gives us three uncomments and one new line for modules.conf. |
| * <module name=" | * <module name=" | ||
| Line 164: | Line 170: | ||
| Make sure to uncomment all three modules. | Make sure to uncomment all three modules. | ||
| - | A little less than 20 lines after uncommenting the permchannels module, you will see a permanent channel definition that's commented out. It looks like this: #< | + | A little less than 20 lines after uncommenting the permchannels module, you will see a permanent channel definition that's commented out. It looks like this: '' |
| It's just an example line showing how to configure a permanent channel. On the line after that, you can add your own to set up your permanent channel. Mine looks like this: | It's just an example line showing how to configure a permanent channel. On the line after that, you can add your own to set up your permanent channel. Mine looks like this: | ||
| Line 198: | Line 204: | ||
| </ | </ | ||
| - | We'll insert our operator after this. In keeping with the rest of the how-to, the operator will be named "beastie" | + | We'll insert our operator after this. In keeping with the rest of the how-to, the operator will be named “beastie” and beastie will have full network admin privileges. |
| Here's what it will look like: | Here's what it will look like: | ||
| Line 216: | Line 222: | ||
| </ | </ | ||
| - | The above should be pretty self-explanatory based on the key=value pairs you see. The two things that require a little clarification are probably password and host. Specifically, | + | The above should be pretty self-explanatory based on the key=value pairs you see. The two things that require a little clarification are probably password and host. Specifically, |
| The value for the password is a sha256 hash of the word s3cret. You may remember that was the plain-text password used for Attila in the opers.conf example that we deleted. You can create a new password hash using the sha256 command-line utility included with FreeBSD. | The value for the password is a sha256 hash of the word s3cret. You may remember that was the plain-text password used for Attila in the opers.conf example that we deleted. You can create a new password hash using the sha256 command-line utility included with FreeBSD. | ||
| Line 227: | Line 233: | ||
| </ | </ | ||
| - | The answer to the question of host=" | + | The answer to the question of '' |
| - | 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. " | + | 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. |
| Other than changing the lame password, there' | Other than changing the lame password, there' | ||
| Line 262: | Line 268: | ||
| The following two commands will enable and start inspircd: | The following two commands will enable and start inspircd: | ||
| - | * sysrc inspircd_enable=" | + | * '' |
| - | * service inspircd start | + | * '' |
| To verify it's up and running, use: | To verify it's up and running, use: | ||
| - | * service inspircd status | + | * '' |
| - | * sockstat | grep 6667 | + | * '' |
| If all is well, you should see something like this: | If all is well, you should see something like this: | ||
| Line 386: | Line 392: | ||
| > #<bind address="" | > #<bind address="" | ||
| > #<bind address=" | > #<bind address=" | ||
| + | 278c278 | ||
| + | < allow=" | ||
| + | --- | ||
| + | > allow=" | ||
| 313c313 | 313c313 | ||
| < resolvehostnames=" | < resolvehostnames=" | ||
| Line 425: | Line 435: | ||
| ==== opers.conf ==== | ==== opers.conf ==== | ||
| - | opers.conf | + | This is an abreviated diff of opers.conf since most of the changes involved deleting the bottom third of the file. |
| + | |||
| + | < | ||
| + | 75c75 | ||
| + | < | ||
| + | --- | ||
| + | > | ||
| + | 94,95d93 | ||
| + | < | ||
| + | < # Operator account with a plaintext password. | ||
| + | 97, | ||
| + | < # name: Oper login that is used to oper up (/OPER < | ||
| + | < # Remember: This is case sensitive. | ||
| + | < | ||
| + | --- | ||
| + | > | ||
| + | > | ||
| + | > | ||
| + | > | ||
| + | > | ||
| + | 101, | ||
| + | [Not shown for brevity.] | ||
| + | </ | ||
| ==== motd.txt ==== | ==== motd.txt ==== | ||
| Line 455: | Line 487: | ||
| See this WikiHow article for a guided step-by-step with pictures: [[ https:// | See this WikiHow article for a guided step-by-step with pictures: [[ https:// | ||
| + | |||
| + | ===== 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' | ||
| + | |||
| + | 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 ====== | ||
| Now that you're running IRC at home, remember to get everyone else in your household using ircII or Pidgin so you can pester them with messages with just the stroke of a keyboard. | Now that you're running IRC at home, remember to get everyone else in your household using ircII or Pidgin so you can pester them with messages with just the stroke of a keyboard. | ||
| - | |||
installing_irc_at_home.1594484661.txt.gz · Last modified: 2020/07/11 16:24 by waxphilosophic