|
|
| (74 intermediate revisions by 24 users not shown) |
| Line 1: |
Line 1: |
| | {{MatrixNavbar}}<br> |
|
| |
|
| == "What is the Matrix?" ==
| | '''Matrix''' is an open, lightweight protocol for decentralized, real-time communication, and Mozilla's preferred open discussion platform. |
| [https://matrix.org/ Matrix] is an open, lightweight protocol for decentralized, real-time communications.
| |
| | |
| After a long evaluation period, Mozilla has switched to Matrix from [[IRC]] as our preferred open discussion platform. Matrix is a huge improvement in usability, accessibility and safety for the Mozilla community, and we're excited to make this change.
| |
|
| |
|
| == Community Participation at Mozilla == | | == 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. | | 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. |
| | |
| == Getting Started ==
| |
| | |
| === New to Matrix, new to Mozilla? ===
| |
| | |
| Start with the [https://riot.im/app/#/welcome Riot webapp] and create an account. Once you're signed in, clicking these links will let you join the [https://riot.im/app/#/room/#general:mozilla.org #general:mozilla.org] channel for general questions or [https://riot.im/app/#/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 Mozilla, already using Matrix? ===
| |
| | |
| If you're already using Matrix, you can join the Mozilla conversation by opening the [https://riot.im/app/#/room/#general:mozilla.org #general:mozilla.org] room for general topics and [https://riot.im/app/#/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; we're working on it and we'll have a longer list of channels here soon. In the meantime, those are friendly channels and the people there will be able to help you find your way around. You can start using Matrix directly via the [https://riot.im/app/ Riot webapp] or one of the many [https://riot.im/ native applications] available.
| |
|
| |
|
| === New to Matrix, already part of Mozilla? ===
| | 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. |
|
| |
|
| [https://chat.mozilla.org/#/login Mozilla's Matrix server] is configured to use Mozilla IAM, and supports the following accounts:
| | == Clients == |
|
| |
|
| * Mozilla LDAP
| | Matrix servers are accessible from a 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]. |
| * [https://www.mozilla.org/firefox/accounts/ Firefox Accounts]
| |
| * [https://github.com/ Github]
| |
| * [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, already part of Mozilla? ===
| |
| | |
| [https://riot.im/app/#/room/#general:mozilla.org Then get over there!]
| |
| | |
| === 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 [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].
| |
| | |
| == Connect to Matrix ==
| |
| | |
| === Register a username ===
| |
| | |
| The quickest way to register a username on Mozilla Matrix is through the web interface.
| |
| | |
| * Open https://chat.mozilla.org/
| |
| | |
| * 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]]
| |
| | |
| * On the sign in page, proceed to Sign in with single sign-on
| |
| | |
| [[File:Chatmo-signin-page.png|frame|none|alt=Sign in page on chat.mozilla.org]]
| |
| | |
| * Pick your choice of services to authenticate from
| |
| | |
| [[File:Am-screen.png|frame|none|alt=Mozilla IAM sign in page]]
| |
| | |
| * Pick your username!
| |
| | |
| [[File:Chatmo-pick-username.png|frame|none|alt=Pick your username on chat.mozilla.org]]
| |
| | |
| === Clients ===
| |
| | |
| 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].
| |
|
| |
|
| The Mozilla Matrix server requires Single Sign-On. Clients which currently support Single Sign-On include: | | The Mozilla Matrix server requires Single Sign-On. Clients which currently support Single Sign-On include: |
| | | {|class="wikitable" |
| * Riot, the software behind [https://chat.mozilla.org chat.mozilla.org]
| | |- |
| ** this is also available as a desktop client: [https://riot.im/download/desktop/ download here]
| | ! style="text-align: center;" | Client |
| * [https://play.google.com/store/apps/details?id=im.vector.app Riot Android] (also [https://f-droid.org/en/packages/im.vector.alpha/ available on F-Droid])
| | ! colspan="3" style="text-align: center;" | Supported OS |
| ** [https://play.google.com/store/apps/details?id=im.vector.riotx RiotX] is the next generation Matrix client for Android (also [https://f-droid.org/en/packages/im.vector.riotx/ available on F-Droid])
| | ! style="text-align: center;" | Note |
| * [https://apps.apple.com/gb/app/riot-im/id1083446067 Riot 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].
| | | id="mx-client-element" | Element Web, the software behind [https://chat.mozilla.org chat.mozilla.org] |
| * [https://github.com/tulir/gomuks gomuks] a terminal client for Matrix
| | | colspan="3" style="text-align: center;" | Web, Browser |
| | | |- |
| ==== Connection parameters ====
| | | [https://element.io/download Element] for Desktop |
| | | | Windows 10+ |
| 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:
| | | Linux |
| | | | macOS |
| {|
| | |- |
| | | [https://www.thunderbird.net/ Thunderbird], through [https://support.mozilla.org/en-US/kb/instant-messaging-and-chat TB Chat] as of version 102 |
| | | Windows |
| | | Linux |
| | | macOS |
| | | See [https://support.mozilla.org/en-US/kb/thunderbird-matrix-chat-faq Single Sign On and FAQ] |
| | |- |
| | |[https://play.google.com/store/apps/details?id=io.element.android.x Element X] for Android (also [https://f-droid.org/en/packages/io.element.android.x/ available on F-Droid]) |
| | | colspan="3" style="text-align:center;" | Android 7+ |
| | |- |
| | | [https://apps.apple.com/app/element-x-secure-chat-call/id1631335820 Element X] for iOS |
| | | colspan="3" style="text-align:center;" | iOS 17+ |
| | |- |
| | |- |
| | |[https://play.google.com/store/apps/details?id=im.vector.app Element] for Android (also [https://f-droid.org/en/packages/im.vector.alpha/ available on F-Droid]) |
| | | colspan="3" style="text-align:center;" | Android 5+ |
| | |- |
| | | [https://apps.apple.com/app/vector/id1083446067 Element] for iOS |
| | | colspan="3" style="text-align:center;" | iOS |
| | |- |
| | | [https://weechat.org/ WeeChat], using [https://github.com/poljar/weechat-matrix/ Matrix protocol script] |
| | | Windows (Cygwin) |
| | | Linux |
| | | macOS |
| | | See [https://github.com/poljar/weechat-matrix/#single-sign-on Single Sign-On instructions] |
| | |- |
| | | [https://github.com/tulir/gomuks gomuks] a terminal-like client |
| | | <s>Windows 7+</s> |
| | | Linux |
| | | |
| | | All Windows builds do not work. |
| |- | | |- |
| | '''Homeserver''' | | | [https://github.com/quotient-im/Quaternion Quaternion] |
| | <nowiki>https://mozilla.modular.im</nowiki>
| | | Windows 7+ |
| | | Linux |
| | | macOS |
| |- | | |- |
| | '''Identity server''' | | | [https://nheko-reborn.github.io/ Nheko Reborn] |
| | <nowiki>https://vector.im</nowiki>
| | | Windows 10+ |
| | | Linux |
| | | macOS |
| |} | | |} |
| | Updated 2025-06-25 |
|
| |
|
| 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.
| | == Feedback == |
| | | For feedback on the use of Element and Matrix at Mozilla, head to [https://chat.mozilla.org/#synchronicity:mozilla.org #synchronicity:mozilla.org]. You can also [mailto:matrix-admins@mozilla.com contact the Mozilla Matrix administration team by email]. |
| === 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:
| |
| ** 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. 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
| |
| | |
| == Commonly used rooms ==
| |
| | |
| === General discussion ===
| |
| * [https://chat.mozilla.org/#/room/#general:mozilla.org #general:mozilla.org ] - General discussions about Mozilla
| |
| * [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/#synchronicity:mozilla.org #synchronicity:mozilla.org] - Sorting out bugs and papercuts in the migration from IRC to Matrix
| |
| | |
| === Project rooms ===
| |
| * [https://chat.mozilla.org/#/room/#www: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])
| |
| * [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])
| |
| | |
| === Specific areas ===
| |
| * [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
| |
|
| |
|
| === Specific locations ===
| | For problems with software used to access the Matrix see the support channel for the software. For problems with the web interface (including chat.mozilla.org) visit [https://chat.mozilla.org/#/room/#element-web:matrix.org #element-web:matrix.org]. |
| * [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/#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/#mozfr:mozilla.org #mozfr:mozilla.org] - Communauté francophone de mozfr.org - French speaking community from 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_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/#mozilla-japan:mozilla.org #mozilla-japan:mozilla.org] - General chat for the Mozilla Japan Community
| |
| * [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/#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/#spain:mozilla.org #spain:mozilla.org] - Comunidad Mozilla en España
| |
| | |
| === Rooms in other languages ===
| |
| | |
| ====Lithuanian====
| |
| * [https://chat.mozilla.org/#/room/#l10n-lt:mozilla.org #l10n-lt:mozilla.org] – Lithuanian l10n community
| |
| | |
| == Feedback ==
| |
| For feedback on Riot and Matrix, head to [https://chat.mozilla.org/#synchronicity:mozilla.org #synchronicity:mozilla.org]
| |
|
| |
|
| == History ==
| | [[category:Matrix]][[category:Software]][[category:Windows]][[category:Protocol]] |
| * On March 2020, Mozilla moved from [[IRC]] to Matrix.
| |
Main | Get Started | Rooms | Moderators | Bots | FAQ | Resources