Changes for page Matrix

Last modified by Stefan Schwalb on 2023/08/28 20:39
From version 33.2
edited by Jonas Jelten
on 2023/08/28 16:22
Change comment: There is no comment for this version
To version 38.1
edited by Jonas Jelten
on 2023/08/28 18:34
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,9 +1,12 @@
1 1  {{toc/}}
2 2  
3 3  
4 -== What is Matrix? ==
4 += What is Matrix? =
5 5  
6 6  
7 +[[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]]
8 +
9 +
7 7  [[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
8 8  
9 9  * You need to register an account at a provider (e.g. tum.de, or lmu.de)
... ... @@ -16,10 +16,10 @@
16 16  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.
17 17  )))
18 18  
19 -So People have their **account on one server** but can write messages **to anyone on other servers**.
22 +So people have their **account on one server** but can write messages **to anyone on other servers**.
20 20  
21 21  
22 -You can create[[ end-to-end encrypted>>https://en.wikipedia.org/wiki/End-to-end_encryption]] **personal or group chats** that are not stored and **not dependent on a central authority** like most other tools (MS Teams, WhatsApp, Zoom, ...).
25 +**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.
23 23  All your messages are **synced** between all your devices - web clients, desktop clients, smartphone apps.
24 24  For additional security, encryption keys of contacts can be verified and then stored as trusted.
25 25  
... ... @@ -27,7 +27,8 @@
27 27  
28 28  Messages are stored and synced between home servers.
29 29  
30 -A user typically has **one account** on one homeserver. You can use any homeserver of your choice - however [[ITO>>doc:CIT.ITO.WebHome]] offers two homeservers:
33 +A user typically has **one account** on one homeserver.
34 +You can use any homeserver of your choice - however **for TUM**, [[ITO>>doc:CIT.ITO.WebHome]] offers two homeservers:
31 31  
32 32  * **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
33 33  * **matrix.tum.de** for TUM accounts: @username:tum.de
... ... @@ -34,146 +34,62 @@
34 34  
35 35  You only need to use one account and can communicate with any other homeserver of the world.
36 36  
37 -If you don't have a CIT or TUM account, you can use a public homeserver instead:
41 +If you don't have a CIT or TUM account, you can use a **public** homeserver instead:
38 38  
39 39  * matrix.org: [[https:~~/~~/app.element.io/#/register>>https://app.element.io/#/register]]
40 40  * or any other homeserver [[https:~~/~~/joinmatrix.org/servers/>>https://joinmatrix.org/servers/]]
41 -* or, host your own homeserver :)
45 +* or, [[host your own homeserver>>https://matrix-org.github.io/synapse/latest/]] 🤩
42 42  
43 43  To use your home server, you have to **use a client** that communicates with your homeserver.
44 44  
45 45  == Clients ==
46 46  
47 -[[Element>>https://element.io/]] is our client of choice. You can use it
51 +[[Element>>https://element.io/]] is our client of choice.
48 48  
49 -* [[on your desktop>>https://element.io/download]]
50 -* as web client:
51 -** matrix.cit.tum.de
52 -** matrix.tum.de
53 -* [[on your smartphone>>https://element.io/download]]
53 +* [[Desktop Client>>https://element.io/download]] (easily provided in [[your Linux distribution of choice>>https://repology.org/project/element-desktop]])
54 +* In your web browser:
55 +** [[matrix.cit.tum.de>>https://matrix.cit.tum.de]]
56 +** [[matrix.tum.de>>https://matrix.tum.de]]
57 +* [[On your smartphone>>https://element.io/download]]
54 54  
55 -== Sign in ==
56 -
57 -=== Sign in to the desktop version ===
58 -
59 -
60 -[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
61 -
62 -[[image:matrixdownload.png||height="284" width="575"]]
63 -
64 -
65 -
66 -If you have an Account you can sign in otherwise you can create a matrix account freely on [[https:~~/~~/app.element.io>>https://app.element.io]] .
67 -
68 68  (% class="wikigeneratedid" %)
69 -[[image:elementdesktopversionlogineng.png||height="745" width="558"]]
60 +Make sure the **home server is set correctly** to your provider!
70 70  
71 -
72 -
73 -(% class="wikigeneratedid" %)
74 -If you have a CIT or TUM Account, you can sign in wit your login data. For this you need the following home server and login data:
75 -
76 76  (% class="box infomessage" %)
77 77  (((
78 -**CIT : Homeserver**: matrix.cit.tum.de , **Username**: CIT-ID (without @cit.tum.de), **Password**: CIT Password
64 +**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)  **Password**: CIT Password
79 79  )))
80 80  
81 81  (% class="box infomessage" %)
82 82  (((
83 -**TUM : Homeserver**: matrix.tum.de , **Username**: LRZ-ID (without @mytum.de or @tum.de), **Password**: LRZ/TUM Password
69 +**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de)  **Password**: LRZ/TUM Password
84 84  )))
85 85  
86 86  
87 -(% class="wikigeneratedid" %)
88 -[[image:signinediteng.png||height="606" width="557"]]
73 +== Using Element for Matrix ==
89 89  
90 -(% class="wikigeneratedid" %)
91 -[[image:desktopelementengcit2.png||height="609" width="556"]]
92 92  
76 +Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎
93 93  
94 -(% class="wikigeneratedid" %)
95 -[[image:desktopelementengcit3.png||height="497" width="555"]]
78 +You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world.
96 96  
97 97  
81 += Invitation of TUM Users =
98 98  
99 -=== Sign in to the web interface ===
83 +When inviting TUM or CIT users to a chat, just enter the following Matrix IDs:
100 100  
85 +**For CIT Accounts**:
101 101  
102 - If you have a CIT or TUM account you can sign in to the web interface of the CIT or TUM otherwise you can create a matrix account freely on [[https:~~/~~/app.element.io>>https://app.element.io]] .
103 -
104 -
105 -==== With TUM login data ====
106 -
107 -
108 -**Webpage**: [[https:~~/~~/matrix.tum.de>>https://matrix.tum.de]]
109 -
110 -**Username**: LRZ-ID (without @mytum.de or @tum.de)
111 -
112 -**Password**: LRZ/TUM Password
113 -
114 -[[image:tumaccountlogineng1.png||height="329" width="582"]]
115 -
116 -
117 -[[image:tumaccountlogineng2n.png||height="357" width="581"]]
118 -
119 -
120 -
121 -==== With CIT login data ====
122 -
123 -**Webpage**: [[https:~~/~~/matrix.cit.tum.de>>https://matrix.cit.tum.de]]
124 -
125 -**Username**: CIT-ID (without @cit.tum.de)
126 -
127 -**Password**: CIT Password
128 -
129 -
130 -[[image:Screenshot 2023-08-23 at 18.16.21.png||height="446" width="573"]]
131 -
132 -
133 -[[image:rbgaccountlogineng2.png||height="353" width="569"]]
134 -
135 -== Create a new chat room ==
136 -
137 -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.
138 -
139 -[[image:addroom1new.png||height="284" width="567"]]
140 -
141 -
142 -You can also block users on other servers from joining the room or enable encryption. You can't change these settings later. The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation. If you create a public room, anyone will be able to find and join this room. You can change this at any time from room settings.
143 -
144 -[[image:addroom3.png||height="673" width="563"]]
145 -
146 -
147 -== Invite People into the chat ==
148 -
149 -You can create either private or group chats and invite other people to the chat room. You can also join to these group chats to participate in existing conversations. If they are already on Matrix, enter their Matrix ID (like @musterma:cit.tum.de). If they are not, enter their email address and they will be invited to join.
150 -
151 -**Note**: If you have only released the room for the CIT or TUM user, only people who are registered on the CIT or TUM server can access this room.
152 -
153 -
154 -Click the button **Invite to this room** to invite people to the group chat. 
155 -
156 -[[image:addroom4new.png||height="571" width="553"]]
157 -
158 -
159 -If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
160 -
161 -[[image:startchat1.png||height="177" width="555"]]
162 -
163 -Enter the following Matrix ID's in the opened window:
164 -
165 -**For CIT Accounts**: e.g. @musterma:cit.tum.de
166 -
167 167  (% class="box infomessage" %)
168 168  (((
169 -@CIT-ID:cit.tum.de
89 +@CIT-ID:cit.tum.de     (e.g. @cooluser:tum.de)
170 170  )))
171 171  
172 -**For TUM Accounts: **e.g. @lr89rbg:tum.de
92 +**For TUM Accounts:**
173 173  
174 174  (% class="box infomessage" %)
175 175  (((
176 - @LRZ-ID:tum.de
96 + @LRZ-ID:tum.de     (e.g. @ga42lol:tum.de)
177 177  )))
178 178  
179 179  **For other Accounts: ** e.g. @musterma:matrix.org
... ... @@ -183,6 +183,15 @@
183 183   @username:domain
184 184  )))
185 185  
186 -and send the invitation to the e-mail address of the person to be invited. The invitation will appear in the Matrix chat window and must be accepted.
106 +The invitation will then appear in the Matrix client of the just-added user and must be accepted.
187 187  
188 -[[image:invitetotestraum.png||height="309" width="548"]]
108 +
109 += Secure Backup =
110 +
111 +Since end-to-end encryption stores decryption **keys only on clients** (the "end"), logging out of the last client would mean loosing all messages.
112 +
113 +Matrix allows to create a encrypted backup of the decryption keys on your homeserver - with a separate passphrase.
114 +
115 +Matrix will ask you to set up your secure backup, and will request the password for the backup keys if needed.
116 +
117 +More information is in the [[official documentation about private chats>>https://matrix.org/docs/chat_basics/private-group-chat/]] 🤓