Changes for page Matrix

Last modified by Stefan Schwalb on 2023/08/28 20:39
From version 28.1
edited by Aysegül Omus
on 2023/08/24 20:01
Change comment: There is no comment for this version
To version 33.2
edited by Jonas Jelten
on 2023/08/28 16:22
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,31 +1,59 @@
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 -== Sign in ==
47 +[[Element>>https://element.io/]] is our client of choice. You can use it
26 26  
27 -You can sign in to the desktop version or web interface.
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]]
28 28  
55 +== Sign in ==
56 +
29 29  === Sign in to the desktop version ===
30 30  
31 31  
... ... @@ -35,143 +35,90 @@
35 35  
36 36  
37 37  
38 -You can sig in, if you have an account or create an account.
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]] .
39 39  
68 +(% class="wikigeneratedid" %)
40 40  [[image:elementdesktopversionlogineng.png||height="745" width="558"]]
41 41  
42 42  
43 -(% class="wikigeneratedid" %)
44 -[[image:elementdesktopversionlogineng2.png||height="766" width="573"]]
45 45  
46 -
47 47  (% class="wikigeneratedid" %)
48 -If you have a CIT or TUM Account, you can sign in wit your login data.
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:
49 49  
50 -(% class="wikigeneratedid" %)
51 -[[image:elementdesktopversionloginengcit1.png||height="621" width="570"]]
52 -
53 -
54 -(% class="wikigeneratedid" %)
55 -For the sign in with your CIT or TUM account, you need the following homeserver:
56 -
57 -
58 58  (% class="box infomessage" %)
59 59  (((
60 -ITO homeserver: matrix.cit.tum.de
78 +**CIT : Homeserver**: matrix.cit.tum.de , **Username**: CIT-ID (without @cit.tum.de), **Password**: CIT Password
61 61  )))
62 62  
63 63  (% class="box infomessage" %)
64 64  (((
65 -TUM homeserver: matrix.tum.de
83 +**TUM : Homeserver**: matrix.tum.de , **Username**: LRZ-ID (without @mytum.de or @tum.de), **Password**: LRZ/TUM Password
66 66  )))
67 67  
68 -(% class="wikigeneratedid" %)
69 -[[image:desktopelementengcit2.png||height="635" width="580"]]
70 70  
71 -
72 -
73 73  (% class="wikigeneratedid" %)
74 -And the login data as follow:
88 +[[image:signinediteng.png||height="606" width="557"]]
75 75  
76 76  (% class="wikigeneratedid" %)
77 -CIT: 
91 +[[image:desktopelementengcit2.png||height="609" width="556"]]
78 78  
79 -(% class="box" %)
80 -(((
81 -username: ITO-ID (without @cit.tum.de)
82 -)))
83 83  
84 -(% class="box" %)
85 -(((
86 -Password: cit.tum Password
87 -)))
88 -
89 89  (% class="wikigeneratedid" %)
90 -TUM:
95 +[[image:desktopelementengcit3.png||height="497" width="555"]]
91 91  
92 -(% class="box" %)
93 -(((
94 -username: LRZ-ID (without @mytum.de or @tum.de)
95 -)))
96 96  
97 -(% class="box" %)
98 -(((
99 -Password: LRZ/TUM Password
100 -)))
101 101  
102 -(% class="wikigeneratedid" %)
103 -[[image:desktopelementengcit3.png||height="522" width="582"]]
104 -
105 -
106 106  === Sign in to the web interface ===
107 107  
108 -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]]
109 109  
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]] .
110 110  
104 +
111 111  ==== With TUM login data ====
112 112  
113 113  
114 -(% class="box" %)
115 -(((
116 -Webpage: https:~/~/matrix.tum.de
117 -)))
108 +**Webpage**: [[https:~~/~~/matrix.tum.de>>https://matrix.tum.de]]
118 118  
119 -(% class="box" %)
120 -(((
121 -username: LRZ-ID (without @mytum.de or @tum.de)
122 -)))
110 +**Username**: LRZ-ID (without @mytum.de or @tum.de)
123 123  
124 -(% class="box" %)
125 -(((
126 -Password: LRZ/TUM Password
127 -)))
112 +**Password**: LRZ/TUM Password
128 128  
129 129  [[image:tumaccountlogineng1.png||height="329" width="582"]]
130 130  
131 131  
132 -[[image:tumaccountlogineng2n.png||height="362" width="589"]]
117 +[[image:tumaccountlogineng2n.png||height="357" width="581"]]
133 133  
134 -==== With CIT login data ====
135 135  
136 -(% class="box" %)
137 -(((
138 -Webpage: https:~/~/matrix.cit.tum.de
139 -)))
140 140  
141 -(% class="box" %)
142 -(((
143 -username: ITO-ID (without @cit.tum.de)
144 -)))
121 +==== With CIT login data ====
145 145  
146 -(% class="box" %)
147 -(((
148 -Password: cit.tum Password
149 -)))
123 +**Webpage**: [[https:~~/~~/matrix.cit.tum.de>>https://matrix.cit.tum.de]]
150 150  
125 +**Username**: CIT-ID (without @cit.tum.de)
151 151  
152 -[[image:Screenshot 2023-08-23 at 18.16.21.png||height="474" width="609"]]
127 +**Password**: CIT Password
153 153  
154 154  
155 -[[image:rbgaccountlogineng2.png||height="377" width="608"]]
130 +[[image:Screenshot 2023-08-23 at 18.16.21.png||height="446" width="573"]]
156 156  
157 -== Create new chat room ==
158 158  
159 -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.
133 +[[image:rbgaccountlogineng2.png||height="353" width="569"]]
160 160  
161 -[[image:addroom1new.png||height="312" width="623"]]
135 +== Create a new chat room ==
162 162  
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.
163 163  
164 -The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation.
139 +[[image:addroom1new.png||height="284" width="567"]]
165 165  
166 -[[image:addroom3.png||height="738" width="617"]]
167 167  
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.
168 168  
169 -== Invite into the chat ==
144 +[[image:addroom3.png||height="673" width="563"]]
170 170  
171 -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.
172 172  
147 +== Invite People into the chat ==
173 173  
174 -**Requirement**: The member which is been invited has registered once on the Matrix Server.
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.
175 175  
176 176  **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.
177 177  
... ... @@ -178,20 +178,20 @@
178 178  
179 179  Click the button **Invite to this room** to invite people to the group chat. 
180 180  
181 -[[image:addroom4new.png||height="655" width="634"]]
156 +[[image:addroom4new.png||height="571" width="553"]]
182 182  
183 183  
184 184  If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
185 185  
186 -[[image:startchat1.png||height="202" width="633"]]
161 +[[image:startchat1.png||height="177" width="555"]]
187 187  
188 -Enter followings in the opened window:
163 +Enter the following Matrix ID's in the opened window:
189 189  
190 190  **For CIT Accounts**: e.g. @musterma:cit.tum.de
191 191  
192 192  (% class="box infomessage" %)
193 193  (((
194 -@ITO-ID:cit.tum.de
169 +@CIT-ID:cit.tum.de
195 195  )))
196 196  
197 197  **For TUM Accounts: **e.g. @lr89rbg:tum.de
... ... @@ -205,7 +205,9 @@
205 205  
206 206  (% class="box infomessage" %)
207 207  (((
208 - name, email address, username  @username:domain
183 + @username:domain
209 209  )))
210 210  
211 -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.
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.
187 +
188 +[[image:invitetotestraum.png||height="309" width="548"]]