Matrix FAQ¶
We are currently aggregating questions.
- If your question isn’t listed here, please contact us.
- Have a look at How-tos.
Will there be any way to migrate Mattermost team with all channels to Matrix?¶
- No, we cannot (technically) and must not (GDPR) transfer whole team/channel structures from mattermost to Matrix. This should therefore be done by teams themselves.
- We provide hints on creation of matrix spaces+rooms, variants of inviting people, etc.
- We will provide a self-service export of channel contents from mattermost. I.e. you will be able to save channel contents in a common format (e.g. HTML), and could for example add this on top of your new matrix channel to allow anyone wanted to browse back the pre-history.
- Feel invited to join our friday open hour at 10:00 to ask / discuss things.
What does “guest” mean in a Helmholtz.cloud Matrix ID?¶
When the Matrix ID is created, the person’s status as recorded by their home center is checked. If the person is not classified as an employee (e. g. guests, students, service providers, …), the suffix -guest is automatically added to the Helmholtz Cloud Matrix ID. This suffix is assigned by the system and cannot be changed.
How long are chat histories stored?¶
Messages and shared files are stored for 3 years and then deleted. This means you can scroll back 3 years in your chat history. Messages and shared files older than that are no longer saved.
Why can’t new members read older messages in encrypted rooms?¶
Whether a new member can read messages sent before they entered a room depends on two things:
- The room’s history visibility setting (Room Settings > Security & Privacy > Who can read history?). Only the option Members (full history) allows new members to read messages sent before they entered the room.
- In encrypted rooms, the new member additionally needs the decryption keys for the older messages. These keys are currently only handed over when the member is invited: the inviter’s client securely shares the keys for past messages with the invitee (see MSC4268).
This leads to the following behaviour in encrypted rooms, even with Members (full history) selected:
| How the member entered the room | Can read older messages? |
|---|---|
| Invited to the room | Yes |
| Joined on their own (e.g. public room, or room visible to a space) | No |
Members who join an encrypted room on their own do not receive the keys for older messages and therefore cannot decrypt them. This is a known limitation of the Matrix protocol, not a bug.
Invite instead of letting people join
If it is important that new members can read the room history of an encrypted room, invite them (see Invite People) instead of letting them join on their own.
In unencrypted rooms, the history visibility setting alone determines who can read the history.
Does Matrix offer a board feature?¶
Matrix do not include a board feature. So, you have to move to another service. With Codebase Gitlab by HZDR and (upcoming) Open Project by HZB Helmholtz Cloud offers two alternatives. Check HIFIS Tip How-to Setup Boards in Gitlab.
How can other people find me? Why can’t my colleague and I find each other in search?¶
Whether someone shows up when you search for people depends on how Matrix handles user search. You appear in another person’s search results when one of these conditions is met:
- You already share a common room with the person searching, or
- You are a member of a public room.
If you and a colleague have never been in a common room together and neither of you is in a public room, you will not (yet) find each other via search. Simply being registered on the server is not enough for this. This is a deliberate privacy setting.
Only for accounts on the same homeserver
The search lists accounts on the same homeserver (helmholtz.cloud).
Members of centers with their own homeserver (e.g. CISPA, KIT, FZJ, GFZ)
do not appear - reach them via their full Matrix ID.
So, to make the first contact, you have to either:
- send an invitation link to your room (see Invite People), or
- enter the person’s full Matrix ID directly (e.g.
@name-xxxxx:helmholtz.cloud, or the respective domain for other centers).
Once you share a room, you will be able to find each other via search afterwards.
Make yourself easier to find
Join a public room such as the
Helmholtz Matrix Community room
(#helmholtz-matrix:helmholtz.cloud).
This satisfies condition 2 above, so others can find you.
Is there an identity server?
There is currently no Matrix identity server for Helmholtz. This means you cannot look up a person’s Matrix account by their email address or phone number - the search works by display name and Matrix ID only.
Why can’t users from other homeservers find our public rooms?¶
The helmholtz.cloud homeserver deliberately does not publish its list of
public rooms to other homeservers. Users on other servers (e.g. other Helmholtz
centers with their own homeserver, or matrix.org) therefore cannot browse or
search our public rooms via their client’s Explore rooms function. This is
a privacy setting: which rooms exist on our server is not exposed to the
outside world.
Public rooms can still be joined from other homeservers - the other person just needs to know the room address. To make your public room reachable for external users:
- Share the full room address, e.g.
#helmholtz-matrix:helmholtz.cloud. The other person can enter it in their client. - Share a room link, e.g.
https://to.matrix.helmholtz.cloud/#/#helmholtz-matrix:helmholtz.cloud(see Invite People). - Or simply invite the person directly via their Matrix ID.
Where can I change my display name?¶
Follow these steps to customize the displayed username with the Matrix Element Client:
- Click on your profile picture at the top left.
- Go to All settings > Account > Manage account.
- Click on the pencil icon behind your name.
- Adjust your display name and click Save.
Can I set a custom status message?¶
Matrix does not yet offer a dedicated field for a custom status message (e.g., “Working from home” or “On leave until DD.MM.”).
As a workaround, you can add such a message to your display name, for example Jane Doe (On leave until 15.06.). See Where can I change my display name? for the necessary steps.
What do the user status colors mean?¶
| State | Icon | Meaning |
|---|---|---|
| Online | 🟢 | User is active (or was active very recently) |
| Away/Idle | ⚪/🟡 | User has been inactive for a while (>3 min) |
| Offline | ⃝ | No active (connected) session |
| Busy | 🔴 | “Do not disturb”. Set via bridges/bots, can’t be set via Element |
You can see a few more details on the right side pane, by clicking on any user’s symbol in a chat. This also works to review your own status.
What does space, team, room, etc. mean?¶
Matrix and Mattermost use different terms for similar (but not completely equal) entities. Have a look a our little “dictionary”:
| Matrix | Mattermost | Meaning |
|---|---|---|
| Space | Team | Top level structure: mandatory and strictly hierarchical in Mattermost; voluntary and allowing multi-assignments of secondary structures in Matrix |
| Room (Gruppe) |
Channel | Secondary structure: Always belonging to exactly one Team in Mattermost; may be unassigned or belong to one or more Spaces in Matrix. |
| People | Member | Individual users. |