Difference between revisions of "Matrix"

From Software Heritage Wiki
Jump to navigation Jump to search
Line 7: Line 7:
 
* [https://app.element.io/#/room/#swh-offtopic:matrix.org '''#swh-offtopic''']: Off-topic discussions
 
* [https://app.element.io/#/room/#swh-offtopic:matrix.org '''#swh-offtopic''']: Off-topic discussions
 
* [https://app.element.io/#/room/#swh-team:matrix.org '''#swh-team''']: private discussions of the core team
 
* [https://app.element.io/#/room/#swh-team:matrix.org '''#swh-team''']: private discussions of the core team
 
+
* [https://app.element.io/#/room/#swh:matrix.org '''#swh''']: general discussions around Software Heritage
  
 
If you use IRC, consider joining the channels.
 
If you use IRC, consider joining the channels.

Revision as of 15:31, 29 June 2022

IRC channels

The following channels have been registered on the libera.chat IRC network for Software Heritage usage.

If you use IRC, consider joining the channels.

If you don't use IRC directly, you can still join our chat channels from your web browser via a Matrix bridge by clicking on the channel names in the list above. You will be asked to create a Element account if you don't have one yet.

IRC authentication

Libera.chat defaults to blocking private messages from unauthentified users! All users should register their nicknames to be able to message one another privately, by following the instructions below. If you're really unable to register, you should ask your correspondent to consider setting usermode -R, and +g

To register an account with NickServ, please follow the registration instructions provided by libera.chat staff.

You will then receive an e-mail containing a link to activate you account. After doing so, you need to configure your client to auto-authenticate. The recommended way of doing that is using SASL authentication.

For matrix, the relevant docs is here: https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv

libera.chat also supports authentication via TLS client certificates (using SASL EXTERNAL).

Matrix bridge

For registering an account through the Matrix bridge (relevant docs here), please follow these instructions:

1. Choose a short nickname (the default nickname picked by the matrix bridge has a [m] and can be quite long, as it defaults to the full local part of your matrix handle)

/msg @appservice:libera.chat !nick <USERNAME>

2. Send this command to NickServ to register your account:

/msg @NickServ:libera.chat register <PASSWORD> <EMAIL>

3. Once you receive the confirmation email with a token, activate your account by using:

/msg @NickServ:libera.chat VERIFY REGISTER <USERNAME> <TOKEN RECEIVED BY EMAIL>

4. Give the Matrix bridge appservice your password so that you get identified automatically when matrix reconnects you to IRC:

/msg @appservice:libera.chat !username <USERNAME>
/msg @appservice:libera.chat !storepass <PASSWORD>

IRC access list

To auto-voice people with a registered nick (only doable by people with +fA access modes will be able to do it), add them to the team channel access list:

/msg chanserv flags #swh-team add <nickname> Staff

Other channels pick their ACLs from that of the #swh-team channel.

If you already have the right (+o ChanServ flag), you can make yourself an operator, with:

/msg chanserv OP #swh-devel