Getting Started with Matrix

:warning: We are still in the initial testing phases for Matrix. Please be aware that the Matrix instance is still in heavy development. If you’d like to collaborate at a more stable location, please use IRC.

This guide will give you more information on how to collaborate with others in the Ubuntu Community using Matrix. Matrix is a form of real-time Internet chat, where you can talk to many other community members using Ubuntu, on topics ranging from idle chit-chat, over community improvements, to support with your Ubuntu.

Though a channel might have many people in it at any one time, they might not always be at their keyboard; so if no-one responds, just wait around and someone will hopefully answer soon enough.

Step 1: Get a client

First, you need a “Client” app in order to connect to Matrix. Although there are many clients to choose from, we strongly recommend using Element since that is the only client that supports all the features used in our community.

Step 2: Get an account

To participate in the conversation, you need a Matrix account. If you already have one, then you can continue to the second step. Otherwise, you need to create an account.

Step 3: Join the Ubuntu space

Once you have an account and a client you can join the Ubuntu Space by typing /join, or by following this link. Here you’ll get an overview of the most relevant chat rooms in our community.

Step 4: Advertise your Matrix ID

To make sure people know how to reach you, it’s best to advertise your Matrix ID in a prominent place. Launchpad now has the option to advertise your Matrix ID on your profile.


Make sure to always write the full matrix ID, including the homeserver, in the form @<username>:<homeserver>. Just specifying your username is not enough, because different people can have the same username on different homeservers.

Step 5: Follow Code of Conduct

When participating in the Ubuntu Community, including our Matrix channels, you agree to abide by the Code of Conduct.

If you have an unpleasant experience where someone else is violating the code of conduct, you can report the message using your client. In Element Web and Desktop, click on the three dots next to a message and select “Report”. Community Moderators will receive your report and take appropriate action.

Next Steps

1 Like