Changes for page Matrix

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

From version 22.2
edited by Aysegül Omus
on 2023/08/23 18:36
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,158 +1,172 @@
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's 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 email. 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  
32 +* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
33 +* **matrix.tum.de** for TUM accounts: @username:tum.de
17 17  
18 -you can use following ito or cit interface of Matrix chat if you have ITO or CIT account:
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 - 1 [[matrix.cit.tum.de (ITO- ID)>>url:https://matrix.cit.tum.de/#/welcome]]
22 - 1 [[matrix.tum.de (LRZ-TUM-ID)>>url:https://matrix.tum.de/#/welcome]]
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 :)
23 23  
24 -You can log in any of them with the appropriate ID and password.
43 +To use your home server, you have to **use a client** that communicates with your homeserver.
25 25  
45 +== Clients ==
26 26  
27 -if you don't have a CIT or TUM account, you can create a matrix account freely on [[https:~~/~~/app.element.io>>url:https://app.element.io/]]
47 +[[Element>>https://element.io/]] is our client of choice. You can use it
28 28  
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]]
29 29  
30 -And[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
55 +== Sign in ==
31 31  
57 +=== Sign in to the desktop version ===
32 32  
59 +
60 +[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
61 +
33 33  [[image:matrixdownload.png||height="284" width="575"]]
34 34  
35 35  
36 -== Log in ==
37 37  
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]] .
38 38  
39 -=== Log in to the web interface with TUM login data ===
68 +(% class="wikigeneratedid" %)
69 +[[image:elementdesktopversionlogineng.png||height="745" width="558"]]
40 40  
41 41  
42 -(% class="box" %)
43 -(((
44 -Webpage: https:~/~/matrix.tum.de
45 -)))
46 46  
47 -(% class="box" %)
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 +(% class="box infomessage" %)
48 48  (((
49 -ID: LRZ-ID (without @mytum.de or @tum.de)
78 +**CIT : Homeserver**: matrix.cit.tum.de , **Username**: CIT-ID (without @cit.tum.de), **Password**: CIT Password
50 50  )))
51 51  
52 -(% class="box" %)
81 +(% class="box infomessage" %)
53 53  (((
54 -Password: LRZ/TUM Password
83 +**TUM : Homeserver**: matrix.tum.de , **Username**: LRZ-ID (without @mytum.de or @tum.de), **Password**: LRZ/TUM Password
55 55  )))
56 56  
57 -[[image:tumaccountlogineng1.png||height="329" width="582"]]
58 58  
87 +(% class="wikigeneratedid" %)
88 +[[image:signinediteng.png||height="606" width="557"]]
59 59  
60 -[[image:tumaccountlogineng2n.png||height="362" width="589"]]
90 +(% class="wikigeneratedid" %)
91 +[[image:desktopelementengcit2.png||height="609" width="556"]]
61 61  
62 -=== Log in to the web interface with cit.tum login data ===
63 63  
64 -(% class="box" %)
65 -(((
66 -Webpage: https:~/~/matrix.cit.tum.de
67 -)))
94 +(% class="wikigeneratedid" %)
95 +[[image:desktopelementengcit3.png||height="497" width="555"]]
68 68  
69 -(% class="box" %)
70 -(((
71 -ID: ITO-ID (without @cit.tum.de)
72 -)))
73 73  
74 -(% class="box" %)
75 -(((
76 -Password: cit.tum Password
77 -)))
78 78  
99 +=== Sign in to the web interface ===
79 79  
80 -[[image:Screenshot 2023-08-23 at 18.16.21.png||height="474" width="609"]]
81 81  
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]] .
82 82  
83 -[[image:rbgaccountlogineng2.png||height="377" width="608"]]
84 84  
105 +==== With TUM login data ====
85 85  
86 -== Create new chat room ==
87 87  
88 -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.
108 +**Webpage**: [[https:~~/~~/matrix.tum.de>>https://matrix.tum.de]]
89 89  
90 -[[image:addroom1.png||height="311" width="622"]]
110 +**Username**: LRZ-ID (without @mytum.de or @tum.de)
91 91  
112 +**Password**: LRZ/TUM Password
92 92  
93 -The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation.
114 +[[image:tumaccountlogineng1.png||height="329" width="582"]]
94 94  
95 -[[image:addroom3.png||height="738" width="617"]]
96 96  
117 +[[image:tumaccountlogineng2n.png||height="357" width="581"]]
97 97  
98 -== Invite into the chat room ==
99 99  
100 -**Requirement**: The member which is been invited has registered once on the Matrix Server.
101 101  
102 -**Note**: If you have only released the room for the cit.tum or TUM user, only people who are registered on the cit.tum or tum server can access this room.
121 +==== With CIT login data ====
103 103  
104 -If you want to invite new members to the room, click the button **Invite to this room**.
123 +**Webpage**: [[https:~~/~~/matrix.cit.tum.de>>https://matrix.cit.tum.de]]
105 105  
106 -[[image:addroom4.png||height="636" width="616"]]
125 +**Username**: CIT-ID (without @cit.tum.de)
107 107  
127 +**Password**: CIT Password
108 108  
109 -Enter followings in the opened window:
110 110  
111 -**For ITO Accounts**: e.g. @musterma:cit.tum.de
130 +[[image:Screenshot 2023-08-23 at 18.16.21.png||height="446" width="573"]]
112 112  
113 -(% class="box infomessage" %)
114 -(((
115 -@ITO-ID:cit.tum.de
116 -)))
117 117  
118 -**For TUM Accounts: **e.g. @lr89rbg:tum.de
133 +[[image:rbgaccountlogineng2.png||height="353" width="569"]]
119 119  
120 -(% class="box infomessage" %)
121 -(((
122 - @lrz-ID:tum.de
123 -)))
135 +== Create a new chat room ==
124 124  
125 -**For other Accounts: ** e.g. @musterma:matrix.org
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.
126 126  
127 -(% class="box infomessage" %)
128 -(((
129 - name, email address, username  @username:domain
130 -)))
139 +[[image:addroom1new.png||height="284" width="567"]]
131 131  
132 -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.
133 133  
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.
134 134  
135 -[[image:invitetotestroom.png||height="593" width="622"]]
144 +[[image:addroom3.png||height="673" width="563"]]
136 136  
137 137  
138 -=== invite to the private chat ===
147 +== Invite People into the chat ==
139 139  
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.
140 140  
141 -**Requirement**: The member which is been invited has registered once on the Matrix Server.
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.
142 142  
143 143  
144 -You can also privatly chat with other in Matrix. If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
154 +Click the button **Invite to this room** to invite people to the group chat. 
145 145  
146 -[[image:startchat1.png||height="202" width="633"]]
156 +[[image:addroom4new.png||height="571" width="553"]]
147 147  
148 148  
149 -Enter followings in the opened window:
159 +If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
150 150  
151 -**For ITO Accounts**: e.g. @musterma:cit.tum.de
161 +[[image:startchat1.png||height="177" width="555"]]
152 152  
163 +Enter the following Matrix ID's in the opened window:
164 +
165 +**For CIT Accounts**: e.g. @musterma:cit.tum.de
166 +
153 153  (% class="box infomessage" %)
154 154  (((
155 -@ITO-ID:cit.tum.de
169 +@CIT-ID:cit.tum.de
156 156  )))
157 157  
158 158  **For TUM Accounts: **e.g. @lr89rbg:tum.de
... ... @@ -159,7 +159,7 @@
159 159  
160 160  (% class="box infomessage" %)
161 161  (((
162 - @lrz-ID:tum.de
176 + @LRZ-ID:tum.de
163 163  )))
164 164  
165 165  **For other Accounts: ** e.g. @musterma:matrix.org
... ... @@ -166,15 +166,9 @@
166 166  
167 167  (% class="box infomessage" %)
168 168  (((
169 - name, email address, username  @username:homeserver
183 + @username:domain
170 170  )))
171 171  
172 -and send the invitation to the e-mail address of the person to be invited. [[image:invitepeople1.png||height="298" width="687"]]
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.
173 173  
174 -
175 -The invitation will appear in the element chat window and must be accepted.
176 -
177 -[[image:invitepeople2.png||height="263" width="686"]]
178 -
179 -
180 -----
188 +[[image:invitetotestraum.png||height="309" width="548"]]