MozillaWiki

Matrix: Difference between revisions

(Guide to pick a username)
(Table is improved)
 
(89 intermediate revisions by 33 users not shown)
Line 1: Line 1:
== Getting Started ==
'''Matrix''' is an open, lightweight protocol for decentralized, real-time communication, and Mozilla's preferred open discussion platform.
=== What is Matrix ===
[https://matrix.org/ Matrix] is an open standard and lightweight protocol for decentralized, real-time communications. Mozilla is officially switching to Matrix, replacing [[IRC]] for public discussions.


Mozilla's Matrix server is configured to use [[IAM/Frequently_asked_questions|Mozilla IAM]] for user management. Mozilla IAM supports the following accounts:
== Community Participation at Mozilla ==
 
The heart of Mozilla is people. We put people first and do our best to recognize, appreciate and respect the diversity of our global contributors. The Mozilla Project welcomes the participation of everyone who shares our goals and wants to contribute in a healthy and constructive manner within our communities. To that end, as  with all Mozilla spaces and events we expect participants in our Matrix forums to support and uphold the Mozilla [https://www.mozilla.org/en-US/about/governance/policies/participation/ Community Participation Guidelines] as a condition of participation.
 
Please note that the great majority of the rooms on our Matrix instance, like Bugzilla and Discourse, are public-facing forums that can be read anonymously, and should be considered a public place. Your participation in public rooms like Mozilla-General will be publicly visible. Some people create alternative accounts or log in with alternative email addresses for this reason. See [https://www.mozilla.org/privacy/websites/ Mozilla's Websites, Communications & Cookies Privacy Notice] for more information on our privacy policies.
 
== Clients ==
 
Matrix servers are accessible from variety of clients on web, desktop, and mobile. You can readily connect to the web client from [[#mx-client-element | Mozilla website]]. Matrix maintains a list of clients on [https://matrix.org/clients/ their website].
 
The Mozilla Matrix server requires Single Sign-On. Clients which currently support Single Sign-On include:
{| style="background: #eee; border: 1px solid #555; padding: 0 10px; text-align: left;"
|-
! style="text-align: center;" | Client
! colspan="3" style="text-align: center;" | Supported OS
|-
| id="mx-client-element" | Element Web, the software behind [https://chat.mozilla.org chat.mozilla.org]
| colspan="3" style="text-align: center;" | Web, Browser
|-
| also available as a [https://element.io/get-started Element Desktop (click to download)]
| Windows 10+
| Linux
| MacOS
|-
| [https://www.thunderbird.net/ Thunderbird], available through [https://support.mozilla.org/en-US/kb/instant-messaging-and-chat Thunderbird Chat] as of version 102.
| Windows
| Linux
|
|-
|[https://play.google.com/store/apps/details?id=im.vector.app Element Android] (also [https://f-droid.org/en/packages/im.vector.alpha/ available on F-Droid])
| Android 5+
|-
! [https://apps.apple.com/app/vector/id1083446067 Element iOS]
! iOS
|-
! weechat, using the [https://github.com/poljar/weechat-matrix/ weechat-matrix protocol script]. Note the [https://github.com/poljar/weechat-matrix/#single-sign-on Single Sign-On instructions]
| colspan="3" style="text-align: center;" | ?
|-
! [https://github.com/tulir/gomuks gomuks] a terminal client for Matrix
|-
| [https://github.com/quotient-im/Quaternion Quaternion]
| Windows 7+
| Linux
| macOS
|-
| [https://nheko-reborn.github.io/ Nheko Reborn]
| Windows 10+
| Linux
| macOS
|}
 
== Getting Started ==
 
=== Mozilla Matrix resources ===
 
Client: https://chat.mozilla.org
<br>Server: matrix.mozilla.org
 
=== New to Matrix, new to Mozilla? ===
 
Start with the [https://chat.mozilla.org/#/welcome Element webapp] and create an account. Once you're signed in, clicking these links will let you join the [https://app.element.io/#/room/#general:mozilla.org #general:mozilla.org] channel for general questions or [https://app.element.io/#/room/#introduction:mozilla.org #introduction:mozilla.org] if you're interested in getting involved with the Mozilla development process. There are lots more channels to choose from - there's a list of some of them below - and we'll have more as soon as we get them sorted out.
 
For more details, scroll down to [https://wiki.mozilla.org/Matrix#Connect_to_Matrix Connect to Matrix ] below.
 
=== New to Matrix, already part of Mozilla? ===
 
[https://chat.mozilla.org/#/login Mozilla's Matrix server] is configured to use Mozilla IAM, and supports the following accounts:


* Mozilla LDAP
* Mozilla LDAP
Line 9: Line 73:
* [https://github.com/ Github]
* [https://github.com/ Github]
* [https://myaccount.google.com/ Google]
* [https://myaccount.google.com/ Google]
Any of those will work if you go through the [https://chat.mozilla.org/ web interface]; the details are in the [https://wiki.mozilla.org/Matrix#Connect_to_Matrix Connect to Matrix ]  section below.
=== Already using Matrix? ===
If you're already using Matrix, you can join the Mozilla conversation by joining the [https://app.element.io/#/room/#general:mozilla.org #general:mozilla.org] room for general topics and [https://app.element.io/#/room/#introduction:mozilla.org #introduction:mozilla.org] if you're interested in getting involved with the Mozilla development process. The whole Mozilla list of rooms isn't settled out and synchronizing across the Matrix ecosystem yet; although many are [https://wiki.mozilla.org/Matrix#Commonly_used_rooms linked below]. In the meantime, those are friendly channels and the people there will be able to help you find your way around.
You can join our rooms using Matrix via the [https://app.element.io Element web app], the [https://element.io Element native mobile app for your platform], or any other Matrix client.
Using Element Web or Desktop you can view our room directory using the following steps:
# Click on the Explore button
[[File:Element Explore button.png|Element Explore button location|frame|none]]
# Click on the dropdown that says "Matrix rooms (yourserver.com)"
[[File:Matrix rooms dropdown.png|frame|none]]
# Click Add a new server
# Type in <code>mozilla.org</code> and click Add
Now you can view the Mozilla server's room directory and join a room.


=== Community Participation Guidelines ===
=== Community Participation Guidelines ===
The heart of Mozilla is people. We put people first and do our best to recognize, appreciate and respect the diversity of our global contributors. The Mozilla Project welcomes contributions from everyone who shares our goals and wants to contribute in a healthy and constructive manner within our community
The heart of Mozilla is people. We put people first and do our best to recognize, appreciate and respect the diversity of our global contributors. The Mozilla Project welcomes contributions from everyone who shares our goals and wants to contribute in a healthy and constructive manner within our community


Despite our very best efforts, occasionally people do experience behaviors on Matrix that are not inline with our [https://www.mozilla.org/en-US/about/governance/policies/participation/ Community Participation Guidelines].  If happens to you, please reach out to the room moderator or use our [https://events.mozilla.org/communityparticipationhotline reporting hotline].
Despite our very best efforts, occasionally people do experience behaviors on Matrix that are not inline with our [https://www.mozilla.org/en-US/about/governance/policies/participation/ Community Participation Guidelines].  If happens to you, please reach out to the room moderator or send a report [https://www.mozilla.org/about/governance/policies/participation/reporting/].


=== Connect to Matrix ===
=== Changing Accounts ===  


==== Register a username ====
You can change your "display name" in Matrix. But because of low-level design decisions in the Matrix protocol, accounts cannot be renamed nor can accounts names be re-used, and deactivating an account is permanent.
 
Also, accounts tied to SSO such as Mozilla's SSO cannot be reassigned to new owners and you cannot change the primary email tied to it.
 
To accomplish such a change:
# create a new account for yourself
# to maintain continuity in conversations, export your encryption keys from the old account and import them into the new account and then (where relevant) using your old account invite your new account into conversations you'd like to continue  (see account settings, in Security And Privacy, under Cryptography near the bottom of that window)
# deactivate the old account
 
== Connect to Matrix ==
=== Register a username ===
The quickest way to register a username on Mozilla Matrix is through the web interface.
The quickest way to register a username on Mozilla Matrix is through the web interface.


* Open https://chat.mozilla.org/
* Open [[#Mozilla_Matrix_resources | web client page on Mozilla.org]]
* Review the CPG and privacy notices and press the Sign In button
* Review the CPG and privacy notices and press the Sign In button
[[File:Chatmo-welcome-screen.png|frame|none|alt=Welcome screen on chat.mozilla.org]]
[[File:Chatmo-welcome-screen.png|frame|none|alt=Welcome screen on chat.mozilla.org]]
Line 30: Line 121:
[[File:Chatmo-pick-username.png|frame|none|alt=Pick your username on chat.mozilla.org]]
[[File:Chatmo-pick-username.png|frame|none|alt=Pick your username on chat.mozilla.org]]


==== Clients ====
==== Connection parameters ====
Matrix supports a variety of clients on web, desktop, and mobile. You can readily connect to the web client from https://chat.mozilla.org/. Matrix maintains a list of clients on [https://matrix.org/clients/ their website].


===== Connection parameters =====
While the default parameters in most clients will work just fine, if you're already part of the Mozilla community or want to connect directly to the Mozilla Matrix instance. To do that, you'll need to change the following settings:
Irrespective of the choice of client, here are the parameters to connect your client to the Mozilla Matrix instance:


'''Homeserver''': <nowiki>https://mozilla.modular.im</nowiki><br />
{|
'''Identity server''': <nowiki>https://vector.im</nowiki>
|-
| '''Homeserver'''
| <nowiki>https://mozilla.modular.im</nowiki>
|-
| '''Identity server'''
| <nowiki>https://vector.im</nowiki>
|}
 
These details will be autofilled for you in most clients if you enter your full username (e.g. @susan:mozilla.org rather than susan) into the username field. In general it is preferable to do that rather than trying to remember what the homeserver URL is.


=== Joining a room ===
=== Joining a room ===
When connected to the Mozilla Matrix server you can join Mozilla rooms and also rooms on other Matrix servers.


There are several different ways to join a room:
There are several different ways to join a room:
Line 46: Line 145:
* You can receive an invitation from another Matrix member.
* You can receive an invitation from another Matrix member.
* There are also platform specific methods:
* There are also platform specific methods:
** On https://chat.mozilla.org/ you can click Explore in the upper left and search the known rooms to see information about the rooms and then preview or join the rooms.
** Using [[#mx-client-element | Element]] you can click the compass icon "Explore rooms" in the upper left next to the search-bar and search the known rooms to see information about the rooms and then preview or join the rooms. On the left side you can select or enter another Matrix server and search for non-Mozilla rooms.
** Other platforms: TBA
** Other platforms: TBA


Line 53: Line 152:
But it is also easy to leave a room. On https://chat.mozilla.org/ find the room name (or icon) in the room list on the left and click the three vertical dots to the left of the name. There are several options on how you want to read the room. plus the option to leave.
But it is also easy to leave a room. On https://chat.mozilla.org/ find the room name (or icon) in the room list on the left and click the three vertical dots to the left of the name. There are several options on how you want to read the room. plus the option to leave.


=== Create your own room ===
==== Viewing Room Members ====
TBA
Once you have joined a room you can view the room members by clicking on the person icon in the top right. You may notice (depending on your client) that all members appear "offline" or greyed out, this is intentional as "presence" is not enabled for the Mozilla homeserver.
 
See the field "enable_presence_by_hs_url" in the configuration file https://chat.mozilla.org/config.json
 
=== Mozilla Space ===
 
The official Mozilla Matrix Space is [https://matrix.to/#/#welcome:mozilla.org #welcome:mozilla.org], but most of the Mozilla related rooms aren't currently in the space.
 
=== Creating a new room ===
 
How you create a new room depends on your client ([https://element.io/help#rooms Element help]).
 
On creation, you can make the decision of whether or not your room should be publicly discoverable or use end-to-end ("E2E") encryption; for public rooms intended to involve community participation, we recommend *not* enabling E2E, as that enables new participants to see scrollback. A public room is one where anyone can join without an invite. I.e. the "''only people who have been invited''" option has not been enabled.
 
Any public room on the server should also invite the moderator account, and provide it the <code>admin</code> role. This will help you administer the room in compliance with the [https://www.mozilla.org/en-US/about/governance/policies/participation/ CPG] and let site moderators support you in the process.
 
Providing access to the moderator account is a two step process:
# Issue the invitation: <code>/invite @moderator:mozilla.org</code>
# After <code>@moderator:mozilla.org</code> joins the room, grant them the admin role.
 
While the Moderator account with only "mod" privileges lets us protect channels against individual bad actors, it does not give that account the access needed to change channel-wide access control lists. You need to grant the Moderator "admin" privileges to be able to take advantage of the collective defense options Matrix provides.


== Commonly used rooms ==
== Commonly used rooms ==
Click link below to go to room through [[#Mozilla_Matrix_resources | web client]] on Mozilla website.


=== General discussion ===
=== General discussion ===
* [https://chat.mozilla.org/#/room/#general:mozilla.org #general:mozilla.org ] - General discussions about Mozilla
<code>#general:mozilla.org</code> or [https://chat.mozilla.org/#/room/#general:mozilla.org link] - General discussions about Mozilla
<br><code>#synchronicity:mozilla.org</code> or [https://chat.mozilla.org/#/room/#synchronicity:mozilla.org link] - Sorting out bugs and papercuts in the migration from IRC to Matrix
 
=== Software Development ===
* [https://chat.mozilla.org/#/room/#introduction:mozilla.org #introduction:mozilla.org] - Help with basics of developing for Mozilla
* [https://chat.mozilla.org/#/room/#developers:mozilla.org #developers:mozilla.org] - General Firefox and Gecko development discussion
* [https://chat.mozilla.org/#/room/#developers:mozilla.org #developers:mozilla.org] - General Firefox and Gecko development discussion
* [https://chat.mozilla.org/#/room/#introduction:mozilla.org #introduction:mozilla.org] - Help with basics of developing for Mozilla
* [https://chat.mozilla.org/#/room/#devtools:mozilla.org #devtools:mozilla.org] - Firefox Developer Tools discussion
* [https://chat.mozilla.org/#/room/#synchronicity:mozilla.org #synchronicity:mozilla.org] - Sorting out bugs and papercuts in the migration from IRC to Matrix
* [https://chat.mozilla.org/#/room/#basket:mozilla.org #basket:mozilla.org] - Development of basket.mozilla.org ([https://github.com/mozmeao/basket basket])
 
* [https://chat.mozilla.org/#/room/#fxa:mozilla.org #fxa:mozilla.org] - Development of Firefox Accounts ([https://github.com/mozilla/fxa fxa])
=== Project channels ===
* [https://chat.mozilla.org/#/room/#pontoon:mozilla.org #pontoon:mozilla.org] - Development of pontoon.mozilla.org ([https://github.com/mozilla/pontoon Pontoon])
* [https://chat.mozilla.org/#/room/#www:mozilla.org #www:mozilla.org] - Development of www.mozilla.org ([https://github.com/mozilla/bedrock bedrock])
* [https://chat.mozilla.org/#/room/#maildev:mozilla.org #maildev:mozilla.org] - Development of Thunderbird ([https://www.thunderbird.net/ thunderbird])
* [https://chat.mozilla.org/#/room/#seamonkey:mozilla.org #seamonkey:mozilla.org] - Development of SeaMonkey ([https://www.seamonkey-project.org/ SeaMonkey])
* [https://chat.mozilla.org/#/room/#necko:mozilla.org #necko:mozilla.org] Development of Firefox's Networking component [[Networking|Necko]]


=== Specific areas ===
=== Specific areas ===
* [https://chat.mozilla.org/#/room/#fx-desktop-community:mozilla.org #fx-desktop-community:mozilla.org] - Discussion about Firefox Desktop
* [https://chat.mozilla.org/#/room/#fx-android-community:mozilla.org #fx-android-community:mozilla.org] - Discussion about Firefox for Android
* [https://chat.mozilla.org/#/room/#l10n-community:mozilla.org #l10n-community:mozilla.org] - Discussion about localization (l10n) of Mozilla applications
* [https://chat.mozilla.org/#/room/#l10n-community:mozilla.org #l10n-community:mozilla.org] - Discussion about localization (l10n) of Mozilla applications
* [https://chat.mozilla.org/#/room/#accessibility:mozilla.org #accessibility:mozilla.org] Discussion of the accessibility (a11y) of Mozilla applications and services
* [https://chat.mozilla.org/#/room/#addons:mozilla.org #addons:mozilla.org] Discussion about Firefox add-ons
* [https://chat.mozilla.org/#/room/#nightly:mozilla.org #nightly:mozilla.org] Discussion about Firefox Nightly
* [https://chat.mozilla.org/#/room/#SUMO:mozilla.org #SUMO:mozilla.org] Discussion about Mozilla Support
* [https://chat.mozilla.org/#/room/#mdn:mozilla.org #mdn:mozilla.org] Discussion about MDN


=== Specific locations ===
=== Specific locations ===
==== Mozilla offices ====
* [https://chat.mozilla.org/#/room/#berlin:mozilla.org #berlin:mozilla.org] - General chat for people in the Berlin office
* [https://chat.mozilla.org/#/room/#berlin:mozilla.org #berlin:mozilla.org] - General chat for people in the Berlin office
* [https://chat.mozilla.org/#/room/#canada:mozilla.org #canada:mozilla.org] - General chat for the Canadian Mozilla community
* [https://chat.mozilla.org/#/room/#taipei:mozilla.org #taipei:mozilla.org] - General chat for people in the Taipei office
* [https://chat.mozilla.org/#/room/#mozfr:mozilla.org #mozfr:mozilla.org] - Communauté francophone de mozfr.org - French speaking community from mozfr.org
* [https://chat.mozilla.org/#/room/#Mozilla_NL:mozilla.org #Mozilla_NL:mozilla.org] - Voor Nederlands sprekende medewerkers en vrijwilligers van Mozilla
* [https://chat.mozilla.org/#/room/#mozilla-hispano:mozilla.org #mozilla-hispano:mozilla.org] - Comunidad en español de Mozilla https://www.mozilla-hispano.org/
* [https://chat.mozilla.org/#/room/#toronto:mozilla.org #toronto:mozilla.org] - General chat for people in the Toronto office
* [https://chat.mozilla.org/#/room/#toronto:mozilla.org #toronto:mozilla.org] - General chat for people in the Toronto office
* [https://chat.mozilla.org/#/room/#vancouver:mozilla.org #vancouver:mozilla.org] - General chat for people in the Vancouver office
* [https://chat.mozilla.org/#/room/#vancouver:mozilla.org #vancouver:mozilla.org] - General chat for people in the Vancouver office
==== Local communities ====
* [https://chat.mozilla.org/#/room/#atlanta:mozilla.org #atlanta:mozilla.org] - General chat for the Mozilla community in and around Atlanta, GA, USA
* [https://chat.mozilla.org/#/room/#canada:mozilla.org #canada:mozilla.org] - General chat for the Canadian Mozilla community
* [https://chat.mozilla.org/#/room/#mozfr:mozilla.org #mozfr:mozilla.org] - ''Communauté Mozilla francophone'' — French-speaking Mozilla community ([https://mozfr.org/ mozfr.org])
* [https://chat.mozilla.org/#/room/#mozilla.de:mozilla.org #mozilla.de:mozilla.org] - ''Deutschsprachige Mozilla-Community'' — German-speaking Mozilla community
* [https://chat.mozilla.org/#/room/#mozilla-hispano:mozilla.org #mozilla-hispano:mozilla.org] - ''Comunidad en español de Mozilla'' ([https://www.mozilla-hispano.org/ mozilla-hispano.org])
* [https://chat.mozilla.org/#/room/#mozilla-japan:mozilla.org #mozilla-japan:mozilla.org] - General chat for the Mozilla Japan Community
* [https://chat.mozilla.org/#/room/#Mozilla_NL:mozilla.org #Mozilla_NL:mozilla.org] - ''Voor Nederlands sprekende medewerkers en vrijwilligers van Mozilla''
* [https://chat.mozilla.org/#/room/#mozilla-uk:mozilla.org #mozilla-uk:mozilla.org] - General chat for the Mozilla UK Community
* [https://chat.mozilla.org/#/room/#moztw:mozilla.org #moztw:mozilla.org] - General chat for the Taiwan Community
* [https://chat.mozilla.org/#/room/#spain:mozilla.org #spain:mozilla.org] - ''Comunidad Mozilla en España''
=== Rooms in other languages ===
French
* [https://github.com/mozfr/besogne/wiki/Matrix French-speaking community wiki page]
German
* [https://chat.mozilla.org/#/room/#mozilla.de:mozilla.org #mozilla.de:mozilla.org] – Deutschsprachige Mozilla-Community
* [https://chat.mozilla.org/#/room/#firefox.de:mozilla.org #firefox.de:mozilla.org] - Deutschsprachiger Firefox-Chat
* [https://chat.mozilla.org/#/room/#common-voice-de:mozilla.org #common-voice-de:mozilla.org] - Alles rund um Common Voice auf Deutsch
Lithuanian
* [https://chat.mozilla.org/#/room/#l10n-lt:mozilla.org #l10n-lt:mozilla.org] – Lithuanian l10n community
Spanish
* [https://matrix.to/#/#mozilla-hispano:mozilla.org #mozilla-hispano:mozilla.org] – Spanish-speaking community / Canal para hispanohablantes
* [https://matrix.to/#/#spain:mozilla.org #spain:mozilla.org] – Spanish community (Spain) / Canal enfocado en España


== Feedback ==
== Feedback ==
For feedback on Riot and Matrix, head to [https://chat.mozilla.org/#synchronicity:mozilla.org #synchronicity:mozilla.org]
For feedback on Element and Matrix, head to [https://chat.mozilla.org/#synchronicity:mozilla.org #synchronicity:mozilla.org]


== History ==
== Links ==
* On March 2020, Mozilla moved from [[IRC]] to Matrix.
Protocol official website: https://matrix.org

Latest revision as of 23:52, 23 January 2024

Matrix is an open, lightweight protocol for decentralized, real-time communication, and Mozilla's preferred open discussion platform.

Community Participation at Mozilla

The heart of Mozilla is people. We put people first and do our best to recognize, appreciate and respect the diversity of our global contributors. The Mozilla Project welcomes the participation of everyone who shares our goals and wants to contribute in a healthy and constructive manner within our communities. To that end, as with all Mozilla spaces and events we expect participants in our Matrix forums to support and uphold the Mozilla Community Participation Guidelines as a condition of participation.

Please note that the great majority of the rooms on our Matrix instance, like Bugzilla and Discourse, are public-facing forums that can be read anonymously, and should be considered a public place. Your participation in public rooms like Mozilla-General will be publicly visible. Some people create alternative accounts or log in with alternative email addresses for this reason. See Mozilla's Websites, Communications & Cookies Privacy Notice for more information on our privacy policies.

Clients

Matrix servers are accessible from variety of clients on web, desktop, and mobile. You can readily connect to the web client from Mozilla website. Matrix maintains a list of clients on their website.

The Mozilla Matrix server requires Single Sign-On. Clients which currently support Single Sign-On include:

Client Supported OS
Element Web, the software behind chat.mozilla.org Web, Browser
also available as a Element Desktop (click to download) Windows 10+ Linux MacOS
Thunderbird, available through Thunderbird Chat as of version 102. Windows Linux
Element Android (also available on F-Droid) Android 5+
Element iOS iOS
weechat, using the weechat-matrix protocol script. Note the Single Sign-On instructions ?
gomuks a terminal client for Matrix
Quaternion Windows 7+ Linux macOS
Nheko Reborn Windows 10+ Linux macOS

Getting Started

Mozilla Matrix resources

Client: https://chat.mozilla.org
Server: matrix.mozilla.org

New to Matrix, new to Mozilla?

Start with the Element webapp and create an account. Once you're signed in, clicking these links will let you join the #general:mozilla.org channel for general questions or #introduction:mozilla.org if you're interested in getting involved with the Mozilla development process. There are lots more channels to choose from - there's a list of some of them below - and we'll have more as soon as we get them sorted out.

For more details, scroll down to Connect to Matrix below.

New to Matrix, already part of Mozilla?

Mozilla's Matrix server is configured to use Mozilla IAM, and supports the following accounts:

Any of those will work if you go through the web interface; the details are in the Connect to Matrix section below.

Already using Matrix?

If you're already using Matrix, you can join the Mozilla conversation by joining the #general:mozilla.org room for general topics and #introduction:mozilla.org if you're interested in getting involved with the Mozilla development process. The whole Mozilla list of rooms isn't settled out and synchronizing across the Matrix ecosystem yet; although many are linked below. In the meantime, those are friendly channels and the people there will be able to help you find your way around.

You can join our rooms using Matrix via the Element web app, the Element native mobile app for your platform, or any other Matrix client.

Using Element Web or Desktop you can view our room directory using the following steps:

  1. Click on the Explore button
 
Element Explore button location
  1. Click on the dropdown that says "Matrix rooms (yourserver.com)"
 
  1. Click Add a new server
  2. Type in mozilla.org and click Add

Now you can view the Mozilla server's room directory and join a room.

Community Participation Guidelines

The heart of Mozilla is people. We put people first and do our best to recognize, appreciate and respect the diversity of our global contributors. The Mozilla Project welcomes contributions from everyone who shares our goals and wants to contribute in a healthy and constructive manner within our community

Despite our very best efforts, occasionally people do experience behaviors on Matrix that are not inline with our Community Participation Guidelines. If happens to you, please reach out to the room moderator or send a report [1].

Changing Accounts

You can change your "display name" in Matrix. But because of low-level design decisions in the Matrix protocol, accounts cannot be renamed nor can accounts names be re-used, and deactivating an account is permanent.

Also, accounts tied to SSO such as Mozilla's SSO cannot be reassigned to new owners and you cannot change the primary email tied to it.

To accomplish such a change:

  1. create a new account for yourself
  2. to maintain continuity in conversations, export your encryption keys from the old account and import them into the new account and then (where relevant) using your old account invite your new account into conversations you'd like to continue (see account settings, in Security And Privacy, under Cryptography near the bottom of that window)
  3. deactivate the old account

Connect to Matrix

Register a username

The quickest way to register a username on Mozilla Matrix is through the web interface.

 
  • On the sign in page, proceed to Sign in with single sign-on
 
  • Pick your choice of services to authenticate from
 
  • Pick your username!
 

Connection parameters

While the default parameters in most clients will work just fine, if you're already part of the Mozilla community or want to connect directly to the Mozilla Matrix instance. To do that, you'll need to change the following settings:

Homeserver https://mozilla.modular.im
Identity server https://vector.im

These details will be autofilled for you in most clients if you enter your full username (e.g. @susan:mozilla.org rather than susan) into the username field. In general it is preferable to do that rather than trying to remember what the homeserver URL is.

Joining a room

When connected to the Mozilla Matrix server you can join Mozilla rooms and also rooms on other Matrix servers.

There are several different ways to join a room:

  • You can follow an external link. (For example, see the links to commonly used rooms lower on this page.)
  • You can follow links from inside a discussion on Matrix.
  • You can receive an invitation from another Matrix member.
  • There are also platform specific methods:
    • Using Element you can click the compass icon "Explore rooms" in the upper left next to the search-bar and search the known rooms to see information about the rooms and then preview or join the rooms. On the left side you can select or enter another Matrix server and search for non-Mozilla rooms.
    • Other platforms: TBA

When you follow a link you you may be given a choice to preview the contents of the room or to join. If the room doesn't allow preview you may be asked if you want to join it without a preview first.

But it is also easy to leave a room. On https://chat.mozilla.org/ find the room name (or icon) in the room list on the left and click the three vertical dots to the left of the name. There are several options on how you want to read the room. plus the option to leave.

Viewing Room Members

Once you have joined a room you can view the room members by clicking on the person icon in the top right. You may notice (depending on your client) that all members appear "offline" or greyed out, this is intentional as "presence" is not enabled for the Mozilla homeserver.

See the field "enable_presence_by_hs_url" in the configuration file https://chat.mozilla.org/config.json

Mozilla Space

The official Mozilla Matrix Space is #welcome:mozilla.org, but most of the Mozilla related rooms aren't currently in the space.

Creating a new room

How you create a new room depends on your client (Element help).

On creation, you can make the decision of whether or not your room should be publicly discoverable or use end-to-end ("E2E") encryption; for public rooms intended to involve community participation, we recommend *not* enabling E2E, as that enables new participants to see scrollback. A public room is one where anyone can join without an invite. I.e. the "only people who have been invited" option has not been enabled.

Any public room on the server should also invite the moderator account, and provide it the admin role. This will help you administer the room in compliance with the CPG and let site moderators support you in the process.

Providing access to the moderator account is a two step process:

  1. Issue the invitation: /invite @moderator:mozilla.org
  2. After @moderator:mozilla.org joins the room, grant them the admin role.

While the Moderator account with only "mod" privileges lets us protect channels against individual bad actors, it does not give that account the access needed to change channel-wide access control lists. You need to grant the Moderator "admin" privileges to be able to take advantage of the collective defense options Matrix provides.

Commonly used rooms

Click link below to go to room through web client on Mozilla website.

General discussion

#general:mozilla.org or link - General discussions about Mozilla
#synchronicity:mozilla.org or link - Sorting out bugs and papercuts in the migration from IRC to Matrix

Software Development

Specific areas

Specific locations

Mozilla offices

Local communities

Rooms in other languages

French

German

Lithuanian

Spanish

Feedback

For feedback on Element and Matrix, head to #synchronicity:mozilla.org

Links

Protocol official website: https://matrix.org

Retrieved from "https://wiki.allizom.org/index.php?title=Matrix&oldid=1249777"