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