Difference between revisions of "Matrix"

From Software Heritage Wiki
Jump to: navigation, search
(IRC access list: add command to op yourself)
(Update instructions for libera.chat and new matrix rooms.)
Line 1: Line 1:
 
== IRC channels ==
 
== IRC channels ==
  
The following channels have been registered on the [https://freenode.net/ Freenode] network for [[Software Heritage]] usage.
+
The following channels have been registered on the [https://libera.chat/ libera.chat] IRC network for [[Software Heritage]] usage.
 +
 
 +
* [https://app.element.io/#/room/#swh-devel:matrix.org '''#swh-devel''']: public development discussions
 +
* [https://app.element.io/#/room/#swh-sysadm:matrix.org '''#swh-sysadm''']: operations team discussions/bots
 +
* [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/#freenode_#swh-devel:matrix.org '''#swh-devel''']: public development discussions
 
* [https://app.element.io/#/room/#freenode_#swh-team:matrix.org '''#swh-team''']: private discussions of the core team
 
* [https://app.element.io/#/room/#freenode_#swh-sysadm:matrix.org '''#swh-sysadm''']: operations team discussions/bots
 
* [https://app.element.io/#/room/#freenode_#softwareheritage:matrix.org '''#softwareheritage''']: general discussions about the project (currently unused)
 
* [https://app.element.io/#/room/#freenode_#swh:matrix.org '''#swh''']: ditto, in case we end up preferring the short version
 
  
 
If you use IRC, consider joining the channels.
 
If you use IRC, consider joining the channels.
Line 15: Line 15:
 
== IRC authentication ==
 
== IRC authentication ==
  
You should register their nick with NickServ using:
+
You should register your nickname with NickServ following [https://libera.chat/guides/registration the registration instructions provided by libera.chat staff].
 
 
/nick <USERNAME>
 
/msg nickserv register <PASSWORD> <EMAIL>
 
 
 
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 [https://freenode.net/kb/answer/sasl SASL authentication].
 
 
 
For Weechat:
 
 
 
/set irc.server.freenode.sasl_username <USERNAME>
 
/set irc.server.freenode.sasl_password <PASSWORD>
 
  
 +
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 [https://libera.chat/guides/sasl 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
 
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
  
Freenode also supports authentication via [https://freenode.net/kb/answer/certfp TLS client certificates].
+
libera.chat also supports authentication via [https://libera.chat/guides/certfp TLS client certificates (using SASL EXTERNAL)].
  
 
=== Matrix bridge ===
 
=== Matrix bridge ===
  
For the Matrix bridge ([https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv relevant docs here]), you first need to choose you IRC nick by sending this to the bridge appservice:
+
For registering an account through the Matrix bridge ([https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv relevant docs here]), please follow these instructions:
  
/msg @appservice-irc:matrix.org !nick <USERNAME>
+
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)
  
Then send this command to NickServ to register your account:
+
/msg @appservice:libera.chat !nick <USERNAME>
  
/msg @freenode_NickServ:matrix.org register <PASSWORD> <EMAIL>
+
2. Send this command to NickServ to register your account:
  
You will then receive an e-mail containing a link to activate you account. You can then identify using:
+
/msg @NickServ:libera.chat register <PASSWORD> <EMAIL>
  
/msg @freenode_NickServ:matrix.org identify <PASSWORD>
+
3. Once you receive the confirmation email with a token, activate your account by using:
  
Then, ask the IRC bridge appservice to remember your password so that you get identified automatically:
+
/msg @NickServ:libera.chat VERIFY REGISTER <USERNAME> <TOKEN RECEIVED BY EMAIL>
  
  /msg @appservice-irc:matrix.org !storepass <USERNAME>:<PASSWORD>
+
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 ==
 
== 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 channel 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
  
/msg chanserv access #swh-devel add zack +V
+
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:
 
If you already have the right (+o ChanServ flag), you can make yourself an operator, with:

Revision as of 16:03, 8 June 2021

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

You should register your nickname with NickServ following 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