Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
service:ircd [2010/02/26 09:38] – Further changes cyan | service:ircd [2022/02/12 18:03] – [About this document] Fixed knowledge pre-reqs bullet list formatting. Andre | ||
---|---|---|---|
Line 4: | Line 4: | ||
The Synchronet IRCd (IRC daemon) service is a static service written in 100% Javascript. | The Synchronet IRCd (IRC daemon) service is a static service written in 100% Javascript. | ||
- | the most complex) service available for Synchronet. | + | the most complex) service available for Synchronet. |
====== About this document ====== | ====== About this document ====== | ||
Line 20: | Line 20: | ||
In short, this document assumes that you know: | In short, this document assumes that you know: | ||
- | * How to use your computer and operating system effectively. | + | |
- | * The basics of IRC and its terminology. | + | * The basics of IRC and its terminology. |
- | * How to use, configure, and make basic modifications to Synchronet. | + | * How to use, configure, and make basic modifications to Synchronet. |
- | * The basics of the Internet (or at least the ability to visualize a routed, distributed network) | + | * The basics of the Internet (or at least the ability to visualize a routed, distributed network) |
====== Installation ====== | ====== Installation ====== | ||
Line 31: | Line 31: | ||
By default, the Synchronet IRCd is installed as a service. | By default, the Synchronet IRCd is installed as a service. | ||
+ | < | ||
[IRC] | [IRC] | ||
Port=6667 | Port=6667 | ||
Options=STATIC | LOOP | Options=STATIC | LOOP | ||
Command=ircd.js | Command=ircd.js | ||
+ | </ | ||
The ' | The ' | ||
Line 44: | Line 46: | ||
You will know if the IRCd has started successfully if you see entries like this in your BBS log: | You will know if the IRCd has started successfully if you see entries like this in your BBS log: | ||
+ | < | ||
srvc 0007 IRC SynchronetIRCd-1.1b(1.102) started. | srvc 0007 IRC SynchronetIRCd-1.1b(1.102) started. | ||
srvc 0007 IRC Reading Config: / | srvc 0007 IRC Reading Config: / | ||
+ | </ | ||
You may have to scroll up to see the message. | You may have to scroll up to see the message. | ||
Line 51: | Line 55: | ||
Test your new IRCd by connecting to it with an IRC client. At the very least, using ' | Test your new IRCd by connecting to it with an IRC client. At the very least, using ' | ||
+ | < | ||
: | : | ||
+ | </ | ||
This is the standard Synchronet IRCd banner, informing you that the IRCd is accepting new connections correctly. | This is the standard Synchronet IRCd banner, informing you that the IRCd is accepting new connections correctly. | ||
Line 75: | Line 81: | ||
(3) Edit your ircd.conf and include a C/N line pair for connecting to ' | (3) Edit your ircd.conf and include a C/N line pair for connecting to ' | ||
+ | < | ||
# | # | ||
# | # | ||
+ | </ | ||
Remove the '#' | Remove the '#' | ||
Line 83: | Line 91: | ||
(4) Restart your BBS (or, if you know how to become an IRC operator, simply use the /REHASH command), and you should see a message similar to the following in your Synchronet console: | (4) Restart your BBS (or, if you know how to become an IRC operator, simply use the /REHASH command), and you should see a message similar to the following in your Synchronet console: | ||
+ | < | ||
srvc 0008 IRC Routing: Auto-connecting to rrx.synchro.net | srvc 0008 IRC Routing: Auto-connecting to rrx.synchro.net | ||
srvc 0008 IRC Routing: Connected! | srvc 0008 IRC Routing: Connected! | ||
srvc 0008 IRC 0018 Accepted new connection: 154.5.119.21 port 6667 | srvc 0008 IRC 0018 Accepted new connection: 154.5.119.21 port 6667 | ||
srvc 0008 IRC Routing: Link with rrx.synchro.net established, | srvc 0008 IRC Routing: Link with rrx.synchro.net established, | ||
+ | </ | ||
If you see any messages in regards to " | If you see any messages in regards to " | ||
Line 104: | Line 114: | ||
The above command is typed from within the Synchronet ' | The above command is typed from within the Synchronet ' | ||
+ | ====== Using JSexec with systemd ====== | ||
+ | |||
+ | Create a file / | ||
+ | < | ||
+ | [Unit] | ||
+ | Description=Synchronet BBS IRCD | ||
+ | After=syslog.target network.target | ||
+ | |||
+ | [Service] | ||
+ | Type=simple | ||
+ | Environment=SBBSROOT=/ | ||
+ | User=sbbs | ||
+ | Group=sbbs | ||
+ | StandardOutput=file:/ | ||
+ | StandardError=file:/ | ||
+ | ExecStart=/ | ||
+ | |||
+ | [Install] | ||
+ | WantedBy=default.target | ||
+ | </ | ||
+ | |||
+ | Or for logging using syslog: | ||
+ | < | ||
+ | [Unit] | ||
+ | Description=Synchronet BBS IRCD | ||
+ | After=syslog.target network.target | ||
+ | |||
+ | [Service] | ||
+ | Type=forking | ||
+ | Environment=SBBSROOT=/ | ||
+ | User=sbbs | ||
+ | Group=sbbs | ||
+ | ExecStart=/ | ||
+ | |||
+ | [Install] | ||
+ | WantedBy=default.target | ||
+ | </ | ||
+ | |||
+ | |||
+ | Then run: | ||
+ | systemctl enable ircd | ||
+ | systemctl daemon-reload | ||
+ | systemctl start ircd | ||
+ | |||
+ | ===== Setting up TLS/Secure Connections ===== | ||
+ | |||
+ | If you are running with JSExec, you can add this line to your ircd.conf in order to accept secure requests: | ||
+ | |||
+ | < | ||
+ | P: | ||
+ | </ | ||
====== About the Synchronet IRC Network (irc.synchro.net) ====== | ====== About the Synchronet IRC Network (irc.synchro.net) ====== | ||
Line 148: | Line 209: | ||
- Private/ | - Private/ | ||
- | [5.3] - Compatibility with other IRCd's | + | ====== |
- | The Synchronet IRCd has only been tested to be link compatible with: | + | The Synchronet IRCd has been tested to be link compatible with: |
* Bahamut 1.4.35, 1.4.36 http:// | * Bahamut 1.4.35, 1.4.36 http:// | ||
Line 159: | Line 220: | ||
====== The Future ====== | ====== The Future ====== | ||
- | Although the original intention of the IRCd was to allow users to | + | Although the original intention of the IRCd was to allow users to interact between one another from the BBS multi-node chat area, that has yet to occur. |
- | interact between one another from the BBS multi-node chat area, that has yet | + | |
- | to occur. | + | |
- | BBS's and not even be aware that they' | + | |
- | for their chat sessions. | + | |
- | client (irc.js) to connect to their local IRC server. | + | |
- | Further compatibility with the later Bahamut daemons is planned, | + | Further compatibility with the later Bahamut daemons is planned, including the server-to-server " |
- | including the server-to-server " | + | |
- | " | + | |
- | of gaining some of the Bahamut channel modes (i.e. +c) Exception modes (+e, | + | |
- | etc) and exception lines (to circumvent K:Lines) may be implemented. | + | |
- | Some sort of mechanism will be implemented to allow individual BBS's | + | Some sort of mechanism will be implemented to allow individual BBS's to share their message and file areas over IRC. This means that you'll be able to DCC send/ |
- | to share their message and file areas over IRC. This means that you'll be | + | |
- | able to DCC send/ | + | |
- | sort of thing. | + | |
- | + | ||
- | I'm sure DigitalMan has a ton of cool ideas, too ;) | + | |
====== Frequently Asked Questions ====== | ====== Frequently Asked Questions ====== | ||
- | |||
- | [7.1] - Installation Questions | ||
Q: After setting up my IRCd, and trying to connect, it gives me an | Q: After setting up my IRCd, and trying to connect, it gives me an | ||
Line 250: | Line 295: | ||
would execute the command like this: '/OPER Sysop < | would execute the command like this: '/OPER Sysop < | ||
Also check out the O:Line section in ircd.conf. | Also check out the O:Line section in ircd.conf. | ||
+ | |||
+ | Q: My ipv6 O:Line isn't working even if I surround the address with | ||
+ | | ||
+ | | ||
+ | A: You need to enclose the whole netmask within the square brackets. Do | ||
+ | | ||
+ | For example: | ||
+ | | ||
+ | |||
+ | Q: I've been forced off of the server with a " | ||
+ | What does this message mean? | ||
+ | |||
+ | A: This message is an indication that the Sysop of your BBS/IRCd has | ||
+ | shut down the BBS, and the IRCd is terminated as a result of that. | ||
+ | It is an indication of explicit termination (i.e., the IRCd was | ||
+ | | ||
Q: My question isn't answered in this document, where can I go? | Q: My question isn't answered in this document, where can I go? | ||
Line 296: | Line 357: | ||
| | ||
| | ||
+ | |||
+ | |||
===== See Also ===== | ===== See Also ===== |