|
2 | 2 |
|
3 | 3 | ## Redbrick InspIRCd |
4 | 4 |
|
5 | | -In 2016/2017 we began work to move to InspIRCd. This was due to the complications in ircd-hybrid and how old it was. |
6 | | -These complications stopped new netsocs joining us so we all agreed to move irc. $ 4 years later after multiple attempts |
7 | | -we had not migrated. Until TCD decided to shutdown their server breaking the network. |
| 5 | +In 2016/2017 we began work to move to InspIRCd. This was due to the complications in ircd-hybrid and how old it was. These complications stopped new netsocs joining us so we all agreed to move irc. $ 4 years later after multiple attempts we had not migrated. Until TCD decided to shutdown their server breaking the network. |
8 | 6 |
|
9 | 7 | We run Inspircd v3 on Metharme. InspIRCd's docs can be found [here](https://docs.inspircd.org/) for configuration specifics. |
10 | 8 |
|
11 | | -IRC is available at `irc.redbrick.dcu.ie` on port `6697`. SSL is required for connection, we do not support non-SSL. |
| 9 | +IRC is available at `irc.redbrick.dcu.ie` on port `6697`. SSL is required for connection, we do not support non-SSL. When connecting from a redbrick server a user will be automatically logged in. If connecting from an external server a user must pass their password on login. |
12 | 10 |
|
13 | | -When connecting from a redbrick server a user will be automatically logged in. If connecting from an external server a |
14 | | -user must pass their password on login. |
15 | | - |
16 | | -For the purpose of external peering of other servers the port `7001` is expose as well. Similarly to clients we only |
17 | | -support SSL on this port. |
| 11 | +For the purpose of external peering of other servers the port `7001` is exposed as well. Similarly to clients we only support SSL on this port. |
18 | 12 |
|
19 | 13 | For docs on connecting and using an IRC client please refer to the [wiki](https://wiki.redbrick.dcu.ie/index.php/IRC). |
20 | 14 |
|
21 | 15 | ## Installation |
22 | 16 |
|
23 | | -InspIRCd is installed with Nix. There is no Nix package for InspIRCd so we compile a specific git tag from source. See |
24 | | -[Nix package](https://github.com/redbrick/nix-configs/tree/master/packages/inspircd) for details on how it is compiled. |
25 | | - |
26 | | -Given we only support SSL and require LDAP, we need to enable both at compile time. |
| 17 | +InspIRCd is installed with Nix. There is no Nix package for InspIRCd so we compile a specific git tag from source. See [Nix package](https://github.com/redbrick/nix-configs/tree/master/packages/inspircd) for details on how it is compiled. Given we only support SSL and require LDAP, we need to enable both at compile time. |
27 | 18 |
|
28 | 19 | ## Configuration |
29 | 20 |
|
30 | | -InspIRCd's configuration is in Nix [here](https://github.com/redbrick/nix-configs/blob/master/services/ircd/inspircd/conf.nix). |
31 | | -This config will be converted to xml on disc. |
| 21 | +InspIRCd's configuration is in Nix [here](https://github.com/redbrick/nix-configs/blob/master/services/ircd/inspircd/conf.nix). This config will be converted to xml on disc. |
32 | 22 |
|
33 | 23 | ### Important Configuration |
34 | 24 |
|
35 | | -_oper_ is a list of admin users on the irc server. Their `OPER` password will need to be manually hashed with |
36 | | -`hmac-sha256`, and placed in a secret on the server to be read in by inspircd. |
37 | | - |
38 | | -_ldapwhitelist_ is a list of cidr addresses that do no require authentication. The list consists of Redbrick public and |
39 | | -private addresses as well as `oldsoc`. |
40 | | - |
41 | | -_link_ is a list of all servers we peer with including the anope services server that runs on the same box. |
| 25 | +- _oper_ is a list of admin users on the irc server. Their `OPER` password will need to be manually hashed with `hmac-sha256`, and placed in a secret on the server to be read in by inspircd. |
| 26 | +- _ldapwhitelist_ is a list of cidr addresses that do no require authentication. The list consists of Redbrick public and private addresses as well as `oldsoc`. |
| 27 | +- _link_ is a list of all servers we peer with including the anope services server that runs on the same box. |
42 | 28 |
|
43 | 29 | ### oldsoc.net |
44 | 30 |
|
45 | | -`oldsoc.net` is a server run by old TCD netsocers. All the users on it are the remaining TCD associates following the |
46 | | -shutdown of TCD IRCd. This server is maintained by its own users and has explicit permission to join IRC without LDAP auth. |
| 31 | +`oldsoc.net` is a server run by old TCD netsocers. All the users on it are the remaining TCD associates following the shutdown of TCD IRCd. This server is maintained by its own users and has explicit permission to join IRC without LDAP auth. |
47 | 32 |
|
48 | 33 | ## Anope |
49 | 34 |
|
50 | | -Redbrick runs Anope services for the entire network. As with |
51 | | -[inspircd we compile](https://github.com/redbrick/nix-configs/tree/master/packages/inspircd) from source. Refer to anopes |
52 | | -[github docs](https://github.com/anope/anope/tree/2.0/docs) for configuration specifics. |
| 35 | +Redbrick runs Anope services for the entire network. As with [inspircd we compile](https://github.com/redbrick/nix-configs/tree/master/packages/inspircd) from source. Refer to anopes [github docs](https://github.com/anope/anope/tree/2.0/docs) for configuration specifics. |
53 | 36 |
|
54 | 37 | Our current Anope is configured with standard mods of chanserv, nickserv and operserv. All config is in [here](https://github.com/redbrick/nix-configs/tree/master/services/ircd/anope/confs). |
55 | 38 |
|
56 | 39 | Anope stores all info in a custom db file on disk. |
57 | 40 |
|
58 | 41 | ## Discord Bridge - `butlerx` |
59 | 42 |
|
60 | | -We run a [bridge](https://github.com/qaisjp/go-discord-irc) between the Redbrick Discord and irc. The configuration for |
61 | | -this is [here](https://github.com/redbrick/nix-configs/tree/master/services/ircd/discord/conf.nix). |
| 43 | +We run a [bridge](https://github.com/qaisjp/go-discord-irc) between the Redbrick Discord and irc. The configuration for this is [here](https://github.com/redbrick/nix-configs/tree/master/services/ircd/discord/conf.nix). |
62 | 44 |
|
63 | | -The bridge adds all users from discord with the suffix `_d2` and all irc users appear as them self but tagged as a bot |
64 | | -in discord. Not all discord channels are on IRC, the config above contains a mapping of irc channels to discord channels |
65 | | -id's. This needs to be manually updated to add more channels. |
| 45 | +The bridge adds all users from discord with the suffix `_d2` and all irc users appear as them self but tagged as a bot in discord. Not all discord channels are on IRC, the config above contains a mapping of irc channels to discord channels id's. This needs to be manually updated to add more channels. |
0 commit comments