---
# System prepended metadata

title: Join the Ansible Community on Matrix!
tags: [matrix & irc]

---

Join the Ansible Community on Matrix!
===

In order to foster an improved real-time communication model, the Ansible Community decided to adopt Matrix as their official place to chat (bridged to IRC).  

Matrix is an open standard and communication protocol for real-time communication. It aims to make real-time communication work seamlessly between different service providers, in the way that standard Simple Mail Transfer Protocol email currently does for store-and-forward email service, by allowing users with accounts at one communications service provider to communicate with users of a different service provider via online chat, voice over IP, and video telephony.

The room links in the General channels or in the Working groups list will take you directly to the relevant rooms.  If there is no appropriate room for your community, please create it.


Let’s get started…

To join the community using Matrix, you need two things:
* a Matrix account (from Matrix.org or any other Matrix homeserver)
* a [Matrix client](https://matrix.org/clients/) (we recommend [Element Webchat](https://app.element.io/))

If you already have a Matrix ID, scroll down to the Sign In to Matrix section below for next steps.

If you do not have an Matrix ID, follow the steps below to [register](/Gqu02SnORhK9pw0uq1z_cg).



---

Register for Matrix account
---
To register for a Matrix account, go to https://app.element.io and follow the steps below.  The registration process will walk you through the steps needed to create your account.



During the registration process it will default to the Element web client for Matrix.  You can always choose a different client later.

Once your account is created, continue to the Account Configuration section for next steps.

Account Configuration
In the Element web client, click on your account in the top left hand corner of the screen.  Then go to All settings -> General -> Discovery menu.
Under the Discovery menu, select ‘Accept’ to accept the Privacy Notice and click ‘Continue’.

The screen will update showing the email address you registered with.  Click on the ‘Share’ button to make it discoverable (i.e. the invite that is linked to your email address will show up in the invite list).


An email will then be sent to your email address.  You will need to click on the link in the email to verify your email account.

Once your email account is verified, go back to the Element client and click the 'Complete' button next to your email address under the Discovery menu.
Next go to the Invites section on the left navigation bar and look to see if you have been invited to any Matrix rooms.


Select the room(s) you wish to join and click on the 'Accept' button.

You are all set, enjoy!  

Sign In to Matrix
Go to https://app.element.io to sign into your Matrix account.




It will ask you to confirm the use of the Element web client, click the ‘Continue’ button to proceed.



Make sure to complete the steps outlined in the Account Configuration section of these instructions, if you have not already done so.



Accepting an email invite to a Matrix room
If you are invited to a Matrix room, follow these instructions in order to accept the invite and start chatting.  You will need to create a Matrix account first if you do not already have one, please follow the instructions under the Register for Matrix account section.

If you already have a Matrix account, proceed with the instructions below.

Make sure you are signed in with your Matrix account before moving to the next step.  Follow the steps outlined in the Sign In to Matrix section.
Follow the instructions outlined in the Account Configuration section next, if you have already not done so.  
Those instructions will walk you through steps required to make your email address discoverable, which will then allow you to accept the invite you received by email.
