Changes for page Matrix

Last modified by Stefan Schwalb on 2023/08/28 20:39

From 37.1 to 38.1

From version 1.1

edited by wikibot
on 2023/02/05 20:31

Change comment: Imported from foswiki

To version 37.1

edited by Jonas Jelten
on 2023/08/28 17:07

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (3 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--RIOT
++Matrix Chat

Author

@@ -1,1 +1,1 @@
--XWiki.wikibot
++XWiki.jelten

Content

@@ -1,975 +5,117 @@
--= Establishing a Matrix Chat =
--
--
--
  {{toc/}}
++== What is Matrix? ==
--There are three ! Matrix-Servers:
--   1 matrix.tum.de (LRZ-ID)
--   1 matrix.in.tum.de (RBG-TUM-ID)
--   1 matrix.ma.tum.de (RBG-TUM-ID)
--   1 matrix.cit.tum.de (RBG-TUM-ID)
--You can log in any of them with the appropriate ID and password.
--The !Element Server is available as web but also as client. It can be found as web interface under the following links:
--[[matrix.in.tum.de (RBG-TUM-ID)>>https://matrix.in.tum.de/#/welcome]]
++[[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]]
--[[matrix.ma.tum.de (RBG-TUM-ID)>>https://matrix.ma.tum.de/#/welcome]]
++[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
++* You need to register an account at a provider (e.g. tum.de, or lmu.de)
++* Whatever your provider is, you can talk to people using other providers
++** (((
++For example {{code language="none"}}@someprofessor:tum.de{{/code}} can communicate with {{code language="none"}}@someresearcher:lmu.de{{/code}}!
++)))
++* (((
++In the same way you can use Outlook or Thunderbird with the same email account, you can use different Matrix apps for the same Matrix account!
++Several apps exist, but we're going to go with "[[Element>>https://element.io/]]" for the sake of simplicity, as it's among the most fully-featured Matrix apps on the market.
++)))
--[[matrix..tum.de (LRZ-TUM-ID)>>https://matrix.tum.de/#/welcome]]
++So people have their **account on one server** but can write messages **to anyone on other servers**.
++
++**Personal or group chats** are[[ end-to-end encrypted>>https://en.wikipedia.org/wiki/End-to-end_encryption]] and **not dependent on a central authority** like most other tools (MS Teams, WhatsApp, Zoom, ...) - anyone can host a Matrix server.
++All your messages are **synced** between all your devices  - web clients, desktop clients, smartphone apps.
++For additional security, encryption keys of contacts can be verified and then stored as trusted.
++== Home Server ==
++Messages are stored and synced between home servers.
++A user typically has **one account** on one homeserver.
++You can use any homeserver of your choice - however **for TUM**, [[ITO>>doc:CIT.ITO.WebHome]] offers two homeservers:
++* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
++* **matrix.tum.de** for TUM accounts: @username:tum.de
--[[ Here>>https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
++You only need to use one account and can communicate with any other homeserver of the world.
++If you don't have a CIT or TUM account, you can use a **public** homeserver instead:
++* matrix.org: [[https:~~/~~/app.element.io/#/register>>https://app.element.io/#/register]]
++* or any other homeserver [[https:~~/~~/joinmatrix.org/servers/>>https://joinmatrix.org/servers/]]
++* or, [[host your own homeserver>>https://matrix-org.github.io/synapse/latest/]] 🤩
--[[image:elementdriver.png||width="1000"]]
++To use your home server, you have to **use a client** that communicates with your homeserver.
++== Clients ==
++[[Element>>https://element.io/]] is our client of choice.
++* [[Desktop Client>>https://element.io/download]] (easily provided in [[your Linux distribution of choice>>https://repology.org/project/element-desktop]])
++* In your web browser:
++** [[matrix.cit.tum.de>>https://matrix.cit.tum.de]]
++** [[matrix.tum.de>>https://matrix.tum.de]]
++* [[On your smartphone>>https://element.io/download]]
++(% class="wikigeneratedid" %)
++Make sure the **home server is set correctly** to your provider!
++(% class="box infomessage" %)
++(((
++**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)  **Password**: CIT Password
++)))
--== Log in ==
++(% class="box infomessage" %)
++(((
++**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de)  **Password**: LRZ/TUM Password
++)))
++== Using Element for Matrix ==
--=== Log in to the web interface with TUM login data ===
++Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎
++You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world.
--{{{
++== Invitation of TUM Users ==
--Webseite: https://matrix.tum.de
++When inviting TUM or CIT users to a chat, just enter the following Matrix IDs:
--ID: LRZ-ID (without @mytum.de or @tum.de)
++**For CIT Accounts**:
--Password: LRZ/TUM Password
++(% class="box infomessage" %)
++(((
++@CIT-ID:cit.tum.de     (e.g. @cooluser:tum.de)
++)))
--
--}}}
--
--
--
--[[image:matrixrbgTUM.png||width="1000"]]
--
--
--
--
--
--[[image:matrixanmeldentum.png||width="1000"]]
--
--
--
--
--
--
--=== Log in to the web interface with in.tum login data ===
--
--{{{
--
--
--Webseite: https://matrix.in.tum.de
--
--ID: RBG(in.tum)-ID (without @in.tum.de)
--
--Password: in.tum Password
--
--}}}
--
--
--
--
--
--[[image:elemtrbgin.png||width="1000"]]
--
--
--
--
--
--[[image:matrixanmeldenIntum.png||width="1000"]]
--
--
--
--
--
--
--=== Log in to the web interface with ma.tum login data ===
--
--{{{
--
--
--Webseite: https://matrix.ma.tum.de
--
--ID: RBG(ma.tum)-ID (without @ma.tum.de)
--
--Password: ma.tum Password
--
--
--}}}
--
--
--
--
--[[image:matrixrbgma.png||width="1000"]]
--
--
--
--
--
--[[image:anmeldenMatumn.png||width="1000"]]
--
--
--
--
--
--
------
--
--== Create new chat room ==
--
--
--If you want to create a new chat room, first click the +-Button next to **Rooms** in the program or on the web inferface and then enter the name of the chat room. You can also block users on other servers from joining the room or enable encryption. You can't change these settings later.
--
--
--
--[[image:createroom+.png||width="1000"]]
--
--
--
--[[image:createroom2.png||width="1000"]]
--
--
--
--
--
--
--=== Explore rooms ===
--
--
--It is also possible to make the room public. Then the chat room is visible to others and can be found via **Explore rooms**. This setting can be changed later.
--
--
--
--[[image:explorerooms.png||width="1000"]]
--
--
--
--
--
--[[image:explorerooms2join.png||width="1000"]]
--
--
--
--
--
--
--The chat room **Test-RBG** is private, so it is not visible to others and participants can only join the room by invitation.
--
--
--
--[[image:createroomtestrbg.png||width="1000"]]
--
--
--
--
--
--
--== Invite into the chat room ==
--
--
--
--**Requirement**: The member which is been invited has registered once on the same TUM/RBG Matrix Server
--
--If you want to invite new members to the room, click the button **Invite to this room** at the top right of the program or the web interface.
--
--
--
--[[image:invitetothisroom1.png||width="1000"]]
--
--
--
--
--
--
--Enter followings in the opened window:
--
--**For in.tum or ma.tum Accounts**: e.g. @musterma:in.tum.de
--
--{{{
--
--@in.tum/ma.tum-ID:in/ma.tum.de
--
--}}}
--
  **For TUM Accounts:**
--{{{
++(% class="box infomessage" %)
++(((
++ @LRZ-ID:tum.de     (e.g. @ga42lol:tum.de)
++)))
-- @lrz-Kennung:tum.de
++**For other Accounts: ** e.g. @musterma:matrix.org
--}}}
++(% class="box infomessage" %)
++(((
++  @username:domain
++)))
++The invitation will then appear in the Matrix client of the just-added user and must be accepted.
--and send the invitation to the e-mail address of the person to be invited, that means to the RBG(in.tum/ma.tum) or TUM email address.
++== Secure Backup ==
++Since end-to-end encryption stores decryption **keys only on clients** (the "end"), logging out of the last client would mean loosing all messages.
--[[image:invitetothisroom.png||width="1000"]]
++Matrix allows to create a encrypted backup of the decryption keys on your homeserver - with a separate passphrase.
++Matrix will ask you to set up your secure backup, and will request the password for the backup keys if needed.
--
--
--
--
--The invitation will appear in the element chat window and must be accepted.
--
--
--
--[[image:maxmustereinladungaccept.png||width="1000"]]
--
--
--
--
--
--
--
--
--
--== private chat ==
--
--
--**Requirement**: The member which is been invited has registered once on the same TUM/RBG Matrix Server
--
--You can also privatly chat with other in !Element. If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
--
--
--
--[[image:startchat1.png||width="1000"]]
--
--
--
--
--
--
--Enter followings in the opened window:
--
--**For in.tum or ma.tum Accounts**: e.g. @musterma:in.tum.de
--
--{{{
--
--@in.tum/ma.tum-ID:in/ma.tum.de
--
--}}}
--
--**For TUM Accounts:**
--
--{{{
--
-- @lrz-Kennung:tum.de
--
--}}}
--
--
--and send the invitation to the e-mail address of the person to be invited, that means to the RBG(in.tum/ma.tum) or TUM email address.
--
--
--
--
--
--[[image:invitepeople1.png||width="1000"]]
--
--
--
--
--
--[[image:invitepeople2.png||width="1000"]]
--
--
--
--
--
--
--The invitation will appear in the element chat window and must be accepted.
--
--
--
--[[image:invitepeople.png||width="1000"]]
--
--
--
--
--
--
--
--
------
--
--== keys for encrypted rooms ==
--
--
--After the first login, the following window appears. Here you can either generate a **Security Key** or a **Security Phrase**. The following screenshot shows how to generate a security key. **This key or passphrase must be entered at every login, to make sure encrypted messages can be decrypted. **
--
--
--
--[[image:setupsecurebackup1.png||width="1000"]]
--
--
--
--
--
--
--Next step you can download or copy the security key. If you click on **Download**, a .txt file with security key will be downloaded. The decryption is now only possible with this key, if you log out and login again.
--
--
--
--
--[[image:saveyoursecuritykeydownload.png||width="1000"]]
--
--
--
--
--
--
--The next time you login, the window below will appear. You can select **Use recovery key** or skip this step.
--
--
--
--[[image:verifythisloginuserecoverykey1sonra.png||width="1000"]]
--
--
--
--
--
--
--Then you can enter the **Secuirity Key** or upload the text file with the **Secuirity Key**.
--
--
--
--[[image:securitykeycontinue2sonra.png||width="1000"]]
--
--
--
--
--
--
--Then click on **DONE** and you can see the encrypted messages.
--
--
--
--[[image:sessionverifieddone3sonra.png||width="1000"]]
--
--
--
--
--
--
--If you lost the recovery key or forgot the passphrase, you can create a new key or enter a new passphrase, especially when you setup your new laptop or you have to log out. Otherwise. the encrypted messages cannot be read.
--To do this, click on the **symbol with 3 dots**  beside your user name and select **Security and Privacy**. Security and Privacy settings can also be found in **All Settings** .
--
--
--
--[[image:testrbg3punkte.png||width="1000"]]
--
--
--
--
--
--
--Then click on **delete backup**.
--
--
--
--[[image:settinggssecurityprivacydeletebackup.png||width="1000"]]
--
--
--
--
--
--
------
--
--== User Settings ==
--
--
--These settings can be found on your own user name. There is a **symbol with 3 dots** (on the web interface there is another symbol). After you click on it, a list of opens. Now you can select **All Settings**, **Security and Privacy**, **Notifications Settings**, **Feedback** and **Logout** from the list.
--
--
--
--[[image:testrbg3punkte.png||width="1000"]]
--
--
--
--
--
--
--=== All Settings ===
--
--
--If you select **All Settings** under User Settings, you can see all detailed settings in the opened window.
--
--==== General ====
--
--
--In General Settings you can enter or change **username**, **language**, **e-mail address** and **phone nummer**. You can also upload, remove or change the **Profile Picture**.
--
--
--
--[[image:settingsgeneral.png||width="1000"]]
--
--
--
--
--
--
--==== Appearance ====
--
--
--You can change the **appearance** settings, which will only affect the cur session.
--
--
--
--[[image:settingsappearance2.png||width="1000"]]
--
--
--
--
--
--[[image:settingsappearance.png||width="1000"]]
--
--
--
--
--
--
--==== Flair ====
--
--
--These settings are irrelevant if you don't belong to any community.
--
--
--==== Notifications ====
--
--
--You can set when and how you want to be notified.
--
--
--
--[[image:settingsnotifications.png||width="1000"]]
--
--
--
--
--
--
--==== Preferences ====
--
--
--Settings for **Room list**, **Composer**, **Timeline** etc.
--
--
--
--[[image:allsettingsspreferencessettings.png||width="1000"]]
--
--
--
--
--
--[[image:allsettingspreferencessettings2.png||width="1000"]]
--
--
--
--
--
--
--==== Voice & Video ====
--
--
--Settings for **Audio Output**, **Microphone**, and Camera. These settings are only available in element App. Peer-to-peer can also be activated for 1-1 call.
--
--
--
--[[image:allsettingsvoiceandvideoapp.png||width="1000"]]
--
--
--
--
--
--
--The following settings are available on the web interface.
--
--
--
--[[image:settingsvoiceandvideo.png||width="1000"]]
--
--
--
--
--
--
--==== Security and Privacy ====
--
--
--In this area you can see with which devices you have been logged on Element. You can mark these sessions and delete them.
--
--
--
--[[image:allsettingssecurityandprivacy1.png||width="1000"]]
--
--
--
--
--
--
--Then there is area for **Key backup**. You can restore or delete the session.
--
--
--
--[[image:allsettingssecurityandprivacy2.png||width="1000"]]
--
--
--
--
--
--
--There are also settings for **Message search**, **Cross-signing** and **Advanced**.
--
--
--
--[[image:allsettingssecurityandprivacy3.png||width="1000"]]
--
--
--
--
--
--
--==== Help & About ====
--
--
--Here are the settings for **Bug reporting**, **FAQ**, **Versions**, **Legal**, **Credits** and **Advanced**.
--
--
--
--[[image:allsettingshelpandabout.png||width="1000"]]
--
--
--
--
--
--[[image:allsettingshelpandabout2.png||width="1000"]]
--
--
--
--
--
--
--
------
--
--== Settings for People ==
--
--
--
--=== General ===
--
--==== Show options ====
--
--
--On the left side of **People**, you can view and adjust the options for all people.
--
--
--
--[[image:peoplelistoptions1.png||width="900"]]
--
--
--
--
--
--[[image:personenallg3punkte.png||width="900"]]
--
--
--
--
--
--
--==== Start chat ====
--
--
--You can invite other users to a chat room or chat privately, if you click on the **+ button** on the left side of people.
--
--
--
--[[image:startchat1.png||width="1000"]]
--
--
--
--
--
--
--
--=== Room Settings ===
--
--
--You can adjust the room settings for private chat by clicking the gear icon at the top.
--
--
--
--[[image:maxmustersettings.png||width="900"]]
--
--
--
--
--
--[[image:roomsettingsmaxmuster.png||width="900"]]
--
--
--
--
--
--
--=== Share room ===
--
--
--If you click on **Share room** at the top, you can share the room with other users.
--
--
--
--[[image:maxmustershareroom.png||width="900"]]
--
--
--
--
--
--[[image:maxmustersharerrom2.png||width="900"]]
--
--
--
--
--
--
--=== Manage Integrations ===
--
--
--If you click the third symbol at the top, you can select existing integrations and add new integrations.
--
--
--
--[[image:maxmustermanageintegrations.png||width="900"]]
--
--
--
--
--
--
--=== Search ===
--
--
--If you click on the **Magnifying glass symbol** at the top, you can search for a word in the chat. The message with this search word will be displayed. You can search for a word in the current chat room or in all chat rooms.
--
--
--
--[[image:maxmustersearch.png||width="900"]]
--
--
--
--
--
--[[image:maxmustersearch2.png||width="900"]]
--
--
--
--
--
--
--=== Show/hide members ===
--
--
--If you click the **person symbol** at the top, you can show or hide members.
--
--
--
--[[image:maxmustermembers.png||width="900"]]
--
--
--
--
--
--[[image:maxmustermembers2.png||width="900"]]
--
--
--
--
--=== Files ===
--If you click the **file symbol** at the top right, you can see all the files that were shared in the chat. If you select a file, you can download or remove it.
--
--
--
--[[image:maxmusterfiles.png||width="900"]]
--
--
--
--
--
--
--=== Notifications ===
--If you click the last symbol on the top right corner, you can see all the notifications in the chat. There you can also see the messages from other chat users. If you click on a message, the message of the person in the corresponding chat room wil be displayed.
--
--
--
--[[image:maxmusternotifications.png||width="900"]]
--
--
--
--[[image:maxmusternotifications2.png||width="900"]]
--
--
--
--
--
--
--=== Room options ===
--
--
--If you click on a **Person** in people, the settings are displayed. The **symbol with 3 dots** leads to room options.
--
--
--
--[[image:peopleroomoptions.png||width="900"]]
--
--
--
--[[image:peoplepunksymbollinks.png||width="900"]]
--
--
--
--
--=== Notification options ===
--
--
--The symbol with **bell** stands for notification options. You can adjust the notification for the selected person.
--
--
--
--[[image:peoplenotificationoptions.png||width="900"]]
--
--
--
--[[image:peoplenotificationsymbollinks.png||width="900"]]
--
--
--
--
--
--
--
------
--
--== Settings for rooms ==
--
--
--=== General ===
--
--
--==== Show options ====
--
--
--On the left side of rooms, you can display and adjust the options for all rooms.
--
--
--
--[[image:roomslistoptions2.png||width="900"]]
--
--
--
--
--
--
--==== Create new room ====
--
--
--If you click the + button, you can create a new chat room.
--
--
--
--[[image:+addroom.png||width="900"]]
--
--
--
--
--
--[[image:+addroom2.png||width="900"]]
--
--
--
--
--
--
--=== Room Options ===
--
--
--If you click the **gear icon** at the top, you can adjust the room settings for chat room.
--
--
--
--[[image:testrbgsettings.png||width="900"]]
--
--
--
--
--
--[[image:roomsettings.png||width="900"]]
--
--
--
--
--
--
--=== Share room ===
--
--
--If you click on **Share room** at the top, you can share the room with other users.
--
--
--
--[[image:roomshareroom.png||width="900"]]
--
--
--
--
--
--[[image:roomshareroom2copy.png||width="900"]]
--
--
--
--
--
--
--=== Manage Integrations ===
--
--
--If you click the third symbol at the top, you can select existing integrations and add new integrations.
--
--
--
--[[image:roommanageintegrations.png||width="900"]]
--
--
--
--
--
--
--=== Search ===
--
--
--
--
--
--If you click on the **Magnifying glass symbol** at the top, you can search for a word in the chat. The message with this search word will be displayed. You can search for a word in the current chat room or in all chat rooms.
--[[image:roomsearch.png||width="900"]]
--
--
--
--
--
--
--
--
--=== Show/hide members ===
--
--
--If you click the **person symbol** at the top, you can show or hide members.
--
--
--
--[[image:roommembers.png||width="900"]]
--
--
--
--
--
--[[image:roommembers2.png||width="900"]]
--
--
--
--
--=== Files ===
--
--
--If you click the **file symbol** at the top right, you can see all the files that were shared in the chat. If you select a file, you can download or remove it.
--
--
--
--[[image:roomsfiles.png||width="900"]]
--
--
--
--
--
--
--=== Notifications ===
--
--
--If you click the last symbol on the top right corner, you can see all the notifications in the chat. There you can also see the messages from other chat users. If you click on a message, the message of the person in the corresponding chat room wil be displayed.
--
--
--
--[[image:roomnotifications.png||width="900"]]
--
--
--
--
--
--
--=== Room options ===
--
--
--If you click on a **Person** in people, the settings are displayed. The **symbol with 3 dots** leads to room options.
--
--
--
--[[image:roomsroomoptions.png||width="900"]]
--
--
--
--
--
--[[image:peoplepunksymbollinks.png||width="900"]]
--
--
--
--
--
--
--=== Notification options ===
--
--
--The symbol with **bell** stands for notification options. You can adjust the notification for the selected person.
--
--
--
--[[image:testrbgnotificationoptions.png||width="900"]]
--
--
--
--
--
--[[image:peoplenotificationsymbollinks.png||width="900"]]
--
--
--
--
--
--
--
--= Important KB-Links (the website is only available in MWN Network): =
--
--1 [[Platzhalter für gelöschte Nachrichten anzeigen/verbergen>>https://kb.in.tum.de/question/2190/element-chat-wie-kann-ich-geloschte-nachrichten-verbergen/?answer=2191#post-id-2191]]
++More information is in the [[official documentation about private chats>>https://matrix.org/docs/chat_basics/private-group-chat/]] 🤓

Changes for page Matrix

Summary

Details

Navigation