Changes for page Matrix

Last modified by Stefan Schwalb on 2023/08/28 20:39
From version 29.1
edited by Aysegül Omus
on 2023/08/24 20:05
Change comment: There is no comment for this version
To version 33.3
edited by Jonas Jelten
on 2023/08/28 16:38
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kahraman
1 +XWiki.jelten
Content
... ... @@ -1,205 +1,93 @@
1 1  {{toc/}}
2 2  
3 3  
4 -= Establishing a Matrix Chat =
4 +== What is Matrix? ==
5 5  
6 6  
7 +[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
7 7  
8 -== What is matrix? ==
9 +* You need to register an account at a provider (e.g. tum.de, or lmu.de)
10 +* Whatever your provider is, you can talk to people using other providers
11 +** (((
12 +For example {{code language="none"}}@someprofessor:tum.de{{/code}} can communicate with {{code language="none"}}@someresearcher:lmu.de{{/code}}!
13 +)))
14 +* (((
15 +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!
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 +)))
9 9  
19 +So People have their **account on one server** but can write messages **to anyone on other servers**.
20 +
10 10  
11 -Matrix is a chat system very similar to E-Mail. People have their account on one server but can write messages to anyone on other servers. For example @someprofessor:tum.de can communicate with @someresearcher:lmu.de.
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, ...).
23 +All your messages are **synced** between all your devices - web clients, desktop clients, smartphone apps.
24 +For additional security, encryption keys of contacts can be verified and then stored as trusted.
12 12  
13 -You can create end-to-end encrypted personal or group chats that are not stored and dependent on a central authority like most other tools (ms teams, whatsapp, zoom, ...) . 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.
26 +== Home Server ==
14 14  
28 +Messages are stored and synced between home servers.
15 15  
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:
16 16  
17 -Download and sign in to the desktop version of Matrix chat
32 +* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
33 +* **matrix.tum.de** for TUM accounts: @username:tum.de
18 18  
35 +You only need to use one account and can communicate with any other homeserver of the world.
19 19  
37 +If you don't have a CIT or TUM account, you can use a public homeserver instead:
20 20  
21 -[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
39 +* matrix.org: [[https:~~/~~/app.element.io/#/register>>https://app.element.io/#/register]]
40 +* or any other homeserver [[https:~~/~~/joinmatrix.org/servers/>>https://joinmatrix.org/servers/]]
41 +* or, host your own homeserver :)
22 22  
43 +To use your home server, you have to **use a client** that communicates with your homeserver.
23 23  
45 +== Clients ==
24 24  
25 -== ==
47 +[[Element>>https://element.io/]] is our client of choice.
26 26  
27 -You can sign in to the desktop version or web interface.
49 +* [[Desktop Client>>https://element.io/download]] (easily provided in [[your Linux distribution of choice>>https://repology.org/project/element-desktop]])
50 +* as web client:
51 +** [[matrix.cit.tum.de>>https://matrix.cit.tum.de]]
52 +** [[matrix.tum.de>>https://matrix.tum.de]]
53 +* [[on your smartphone>>https://element.io/download]]
28 28  
29 -=== Sign in to the desktop version ===
30 -
31 -
32 -[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
33 -
34 -[[image:matrixdownload.png||height="284" width="575"]]
35 -
36 -
37 -
38 -You can sig in, if you have an account or create an account.
39 -
40 -[[image:elementdesktopversionlogineng.png||height="745" width="558"]]
41 -
42 -
43 43  (% class="wikigeneratedid" %)
44 -[[image:elementdesktopversionlogineng2.png||height="766" width="573"]]
56 +Make sure the **home server is set correctly** to your provider!
45 45  
46 -
47 -(% class="wikigeneratedid" %)
48 -If you have a CIT or TUM Account, you can sign in wit your login data.
49 -
50 -
51 -
52 -(% class="wikigeneratedid" %)
53 -For the sign in with your CIT or TUM account, you need the following homeserver:
54 -
55 -
56 56  (% class="box infomessage" %)
57 57  (((
58 -CIT homeserver: matrix.cit.tum.de
60 +**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)  **Password**: CIT Password
59 59  )))
60 60  
61 61  (% class="box infomessage" %)
62 62  (((
63 -TUM homeserver: matrix.tum.de
65 +**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de)  **Password**: LRZ/TUM Password
64 64  )))
65 65  
66 66  
67 -(% class="wikigeneratedid" %)
68 -[[image:elementdesktopversionloginengcit1.png||height="621" width="570"]]
69 +== Basic Usage of Element ==
69 69  
70 -(% class="wikigeneratedid" %)
71 -[[image:desktopelementengcit2.png||height="635" width="580"]]
72 72  
72 +Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎
73 73  
74 -(% class="wikigeneratedid" %)
75 -And the login data as follow:
76 76  
77 -(% class="wikigeneratedid" %)
78 -CIT: 
75 +=== Invitation of TUM Users ===
79 79  
80 -(% class="box" %)
81 -(((
82 -username: CIT-ID (without @cit.tum.de)
83 -)))
77 +When inviting TUM or CIT users to a chat, just enter the following Matrix IDs:
84 84  
85 -(% class="box" %)
86 -(((
87 -Password: cit.tum Password
88 -)))
79 +**For CIT Accounts**:
89 89  
90 -(% class="wikigeneratedid" %)
91 -TUM:
92 -
93 -(% class="box" %)
94 -(((
95 -username: LRZ-ID (without @mytum.de or @tum.de)
96 -)))
97 -
98 -(% class="box" %)
99 -(((
100 -Password: LRZ/TUM Password
101 -)))
102 -
103 -(% class="wikigeneratedid" %)
104 -[[image:desktopelementengcit3.png||height="522" width="582"]]
105 -
106 -
107 -=== Sign in to the web interface ===
108 -
109 -If you don't a CIT or TUM account, you can create a matrix account freely on [[https:~~/~~/app.element.io>>https://app.element.io]]
110 -
111 -
112 -==== With TUM login data ====
113 -
114 -
115 -(% class="box" %)
116 -(((
117 -Webpage: https:~/~/matrix.tum.de
118 -)))
119 -
120 -(% class="box" %)
121 -(((
122 -username: LRZ-ID (without @mytum.de or @tum.de)
123 -)))
124 -
125 -(% class="box" %)
126 -(((
127 -Password: LRZ/TUM Password
128 -)))
129 -
130 -[[image:tumaccountlogineng1.png||height="329" width="582"]]
131 -
132 -
133 -[[image:tumaccountlogineng2n.png||height="362" width="589"]]
134 -
135 -==== With CIT login data ====
136 -
137 -(% class="box" %)
138 -(((
139 -Webpage: https:~/~/matrix.cit.tum.de
140 -)))
141 -
142 -(% class="box" %)
143 -(((
144 -username: CIT-ID (without @cit.tum.de)
145 -)))
146 -
147 -(% class="box" %)
148 -(((
149 -Password: cit.tum Password
150 -)))
151 -
152 -
153 -[[image:Screenshot 2023-08-23 at 18.16.21.png||height="474" width="609"]]
154 -
155 -
156 -[[image:rbgaccountlogineng2.png||height="377" width="608"]]
157 -
158 -== Create new chat room ==
159 -
160 -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.
161 -
162 -[[image:addroom1new.png||height="312" width="623"]]
163 -
164 -
165 -The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation.
166 -
167 -[[image:addroom3.png||height="738" width="617"]]
168 -
169 -
170 -== Invite into the chat ==
171 -
172 -There are two types of chat, private or group chat. 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.
173 -
174 -
175 -**Requirement**: The member which is been invited has registered once on the Matrix Server.
176 -
177 -**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.
178 -
179 -
180 -Click the button **Invite to this room** to invite people to the group chat. 
181 -
182 -[[image:addroom4new.png||height="655" width="634"]]
183 -
184 -
185 -If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
186 -
187 -[[image:startchat1.png||height="202" width="633"]]
188 -
189 -Enter followings in the opened window:
190 -
191 -**For CIT Accounts**: e.g. @musterma:cit.tum.de
192 -
193 193  (% class="box infomessage" %)
194 194  (((
195 -@CIT-ID:cit.tum.de
83 +@CIT-ID:cit.tum.de     (e.g. @cooluser:tum.de)
196 196  )))
197 197  
198 -**For TUM Accounts: **e.g. @lr89rbg:tum.de
86 +**For TUM Accounts:**
199 199  
200 200  (% class="box infomessage" %)
201 201  (((
202 - @LRZ-ID:tum.de
90 + @LRZ-ID:tum.de     (e.g. @ga42lol:tum.de)
203 203  )))
204 204  
205 205  **For other Accounts: ** e.g. @musterma:matrix.org
... ... @@ -206,7 +206,9 @@
206 206  
207 207  (% class="box infomessage" %)
208 208  (((
209 - name, email address, username  @username:domain
97 + @username:domain
210 210  )))
211 211  
212 -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.
100 +The invitation will then appear in the Matrix client of the just-added user and must be accepted.
101 +
102 +