matrix & irc
A random collection of notes on Matrix for our use. Contributions welcome, either as new questions to answer (skip to the end) or by adding answers.
Some questions have tags:
Bridge
is for questions about how Matrix interacts with IRCIRC
is for information for IRC users coming to MatrixIf anything is not answered, feel free to hop into https://matrix.to/#/#social:ansible.com to chat with us and ask!
Matrix is decentralised (like email) so there are many places you could register.
We do have accounts on chat.ansible.im
- however, for various reasons we cannot offer open registration to anyone. We are happy to grant an account to known contributors - please see token-based registration below.
Otherwise, the Ansible community is fully available over federation, so any other Matrix account you may have will also work. If you don't have one at all, matrix.org is the default (and largest) server to register on.
(You can self-host a homeserver if you wish, but that is beyond the scope of this FAQ)
Start with Element as it covers most usecases fairly well, and has webchat, desktop, and mobile apps.
If Element doesn't suit you, then Matrix has many others clients to try out. You can also check out This Week In Matrix where new clients are regularly featured.
There are many ways!
If you're just looking to find the list of Ansible Community rooms, you should head to #space:ansible.com to see the Ansible Space. Welcome!
To find rooms more generally, you need to use the directory. Matrix can search rooms, but because of the decentralisation, you will need to know what directory to look in:
Selecting Explore public rooms (in two places, green center button, and in the sidebar) or clicking the compass next to the room filter in the sidebar will bring up the search:
If you don't see the rooms you want, you can click the server dropdown (that says "Matrix rooms") and add ansible.com
or ansible.im
as a new server. You'll then be able to see the directory from that server.
A person may send you a room ID to join. If you're in Element or another client that supports room links, you can join just by clicking it!
You can also use URLs - e.g. https://matrix.to/#/#social:ansible.com will take you to our new-user room, where you can ask more questions!
Finally, there's always text - sending a message (in any room) like /join <room-id>
will work too.
The Ansible Communication docs have a list of commonly used rooms, so you can join from there directly!
In Element:
IMPORTANT: If you enable encryption for your room in settings (see the pictures below), you cannot disable encryption in the future. If you need to bridge the room with IRC later, you will not be able to do it with encryption enabled.
Because anyone can create rooms on Matrix, the Ansible Community needs a way to designate "official" rooms. You can tell an official room in three ways:
ansible.com
room alias as it's primary addressOfficial rooms are also subject to the Ansible Code of Conduct so that we can safeguard our community.
If you would like your room to be official, please contact the Community Team via ansible-community@redhat.com - we will ask you accept the CoC, and promote the moderation bot to admin power in the room, after which we can add the alias and put the room in the space.
Very similar to rooms - to start a new chat you can:
/query <user id>
as a text command
Matrix has pretty rich notification settings. You can choose the level notifications per-room (silent, normal, noisy) and what things get notified for at each level. Default is "noisy" for 1:1 chats (pings you for every message, and "normal" for group rooms (pings you for highlighted words and namechecks)
You can also configure Matrix to email you about messages, which may be useful if you only check your client infrequently.
In Element, go to Settings > Notifications and look at "Messages containing keywords" - keywords is clickable:
That will open a dialog to enter keywords.
Nope! Matrix gives you persistence by default, so you can log back in and get your messages later, or from another client.
This is only needed if you want to join a restricted (+r) room or private-message an IRC user; joining public Ansible rooms from Matrix should work with unauthenticated Matrix accounts. This process will also mean you get your op priviledges from IRC (if you have any :P)
Should you decide you need to, this is the process:
@appservice:libera.chat
!username libera-sasl-username
!storepass libera-sasl-password
!nick preferred-irc-nickname
!reconnect
to relogin & check it all workedYou can send !listrooms
to appservice at anytime to get a list of what IRC channels you are in.
Token-based registration has been enabled on chat.ansible.im
however the UX in Element hasn't been fully implemented, so it's not obvious how to use it.
ansible.im
account you will need a token. Please contact the community team to get one using one of the following options:
If the token is valid, your account will be created and you will be logged in.
If you provided an email address in step 4, then you will get an email before providing the token. This means you can start the process, get a token from us, and then continue by using the link in your mail.
Note that the emails are automated and likely to be flagged as spam. Look for a mail from noreply@ansible-accounts.ems.host
if you think it hasn't arrived