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.
- Element Web is the simplest option. It works right inside your browser, so you don’t need to install anything! Just open Element Web.
- You can also install Element on every operating system. If you’re on Ubuntu, you can easily install the
element-desktopsnap. For other operating systems, download Element.
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.
- Regular community members that need a new Matrix account can register at
matrix.orgfor free. Alternatively, there are many other providers you can choose that work in open federation.
- If you’re an Ubuntu Member or work at Canonical, you can register an account on the
Step 3: Join the Ubuntu space⚓
Once you have an account and a client you can join the Ubuntu Space by typing
/join #community:ubuntu.com, or by following this link. Here you’ll get an overview of the most relevant chat rooms in our community.
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.
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.
- Do you have multiple Matrix accounts and want to use them at the same time? Take a look at Using Multiple Matrix Accounts
- Do you want to create rooms for your own community? Take a look at our room administration docs
- Do you want to know who is in charge of moderation and policy making on our homeserver? Take a look at the Ubuntu Matrix Governance Structure