Changes for page Matrix

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

From version 14.1
edited by Aysegül Omus
on 2023/08/22 00:07
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,160 +1,188 @@
1 -= Establishing a Matrix Chat =
1 +{{toc/}}
2 2  
3 -%TOC
4 4  
5 -There are two Matrix-Servers:
6 - 1 matrix.tum.de (LRZ-ID)
7 - 1 matrix.cit.tum.de (ITO-ID)
4 +== What is Matrix? ==
8 8  
9 -You can log in any of them with the appropriate ID and password.
10 -The Matrix Server is available as web but also as client. It can be found as web interface under the following links:
11 11  
12 -[[matrix.cit.tum.de (ITO- ID)>>url:https://matrix.cit.tum.de/#/welcome]]
7 +[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
13 13  
14 -[[matrix.tum.de (LRZ-TUM-ID)>>url:https://matrix.tum.de/#/welcome]]
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 +)))
15 15  
19 +So People have their **account on one server** but can write messages **to anyone on other servers**.
20 +
16 16  
17 -[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
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.
18 18  
19 -[[image:elementdriver.png||width="1000"]]
26 +== Home Server ==
20 20  
28 +Messages are stored and synced between home servers.
21 21  
22 -== Log in ==
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:
23 23  
32 +* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
33 +* **matrix.tum.de** for TUM accounts: @username:tum.de
24 24  
25 -=== Log in to the web interface with TUM login data ===
35 +You only need to use one account and can communicate with any other homeserver of the world.
26 26  
37 +If you don't have a CIT or TUM account, you can use a public homeserver instead:
27 27  
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 :)
28 28  
29 -{{{webpage: https://matrix.tum.de
43 +To use your home server, you have to **use a client** that communicates with your homeserver.
30 30  
31 -ID: LRZ-ID (without @mytum.de or @tum.de)
45 +== Clients ==
32 32  
33 -Password: LRZ/TUM Password
47 +[[Element>>https://element.io/]] is our client of choice. You can use it
34 34  
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]]
35 35  
36 -}}}
55 +== Sign in ==
37 37  
57 +=== Sign in to the desktop version ===
38 38  
39 39  
40 -[[image:matrixrbgTUM.png||width="1000"]]
60 +[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
41 41  
62 +[[image:matrixdownload.png||height="284" width="575"]]
42 42  
43 43  
44 -[[image:matrixanmeldentum.png]]
45 45  
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]] .
46 46  
68 +(% class="wikigeneratedid" %)
69 +[[image:elementdesktopversionlogineng.png||height="745" width="558"]]
47 47  
48 -=== Log in to the web interface with cit.tum login data ===
49 49  
50 -{{{webpage: https://matrix.cit.tum.de
51 51  
52 -ID: ITO(cit.tum)-ID (without @cit.tum.de)
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:
53 53  
54 -Password: cit.tum Password
76 +(% class="box infomessage" %)
77 +(((
78 +**CIT : Homeserver**: matrix.cit.tum.de , **Username**: CIT-ID (without @cit.tum.de), **Password**: CIT Password
79 +)))
55 55  
56 -}}}
81 +(% class="box infomessage" %)
82 +(((
83 +**TUM : Homeserver**: matrix.tum.de , **Username**: LRZ-ID (without @mytum.de or @tum.de), **Password**: LRZ/TUM Password
84 +)))
57 57  
58 58  
59 -[[image:elemtrbgin.png||width="1000"]]
87 +(% class="wikigeneratedid" %)
88 +[[image:signinediteng.png||height="606" width="557"]]
60 60  
90 +(% class="wikigeneratedid" %)
91 +[[image:desktopelementengcit2.png||height="609" width="556"]]
61 61  
62 -[[image:matrixanmeldenIntum.png||width="1000"]]
63 63  
94 +(% class="wikigeneratedid" %)
95 +[[image:desktopelementengcit3.png||height="497" width="555"]]
64 64  
65 -----
66 66  
67 -== Create new chat room ==
68 68  
99 +=== Sign in to the web interface ===
69 69  
70 -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.
71 71  
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]] .
72 72  
73 -todo- screenshot
74 74  
105 +==== With TUM login data ====
75 75  
76 76  
77 -[[image:createroom2.png||width="1000"]]
108 +**Webpage**: [[https:~~/~~/matrix.tum.de>>https://matrix.tum.de]]
78 78  
110 +**Username**: LRZ-ID (without @mytum.de or @tum.de)
79 79  
80 -The chat room **Test-RBG** is private, so it is not visible to others and participants can only join the room by invitation.
112 +**Password**: LRZ/TUM Password
81 81  
82 -[[image:createroomtestrbg.png||width="1000"]]
114 +[[image:tumaccountlogineng1.png||height="329" width="582"]]
83 83  
84 84  
85 -== Invite into the chat room ==
117 +[[image:tumaccountlogineng2n.png||height="357" width="581"]]
86 86  
87 87  
88 -**Requirement**: The member which is been invited has registered once on the same TUM/ITO Matrix Server
89 89  
90 -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.
121 +==== With CIT login data ====
91 91  
92 -[[image:invitetothisroom1.png||width="1000"]]
123 +**Webpage**: [[https:~~/~~/matrix.cit.tum.de>>https://matrix.cit.tum.de]]
93 93  
125 +**Username**: CIT-ID (without @cit.tum.de)
94 94  
95 -Enter followings in the opened window:
127 +**Password**: CIT Password
96 96  
97 -**For in.tum or ma.tum Accounts**: e.g. @musterma:cit.tum.de
98 98  
99 -{{{@cit.tum-ID:cit.tum.de
130 +[[image:Screenshot 2023-08-23 at 18.16.21.png||height="446" width="573"]]
100 100  
101 -}}}
102 102  
103 -**For TUM Accounts:**
133 +[[image:rbgaccountlogineng2.png||height="353" width="569"]]
104 104  
105 -{{{ @lrz-Kennung:tum.de
135 +== Create a new chat room ==
106 106  
107 -}}}
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.
108 108  
139 +[[image:addroom1new.png||height="284" width="567"]]
109 109  
110 -and send the invitation to the e-mail address of the person to be invited, that means to the ITO(cit.tum) or TUM email address.
111 111  
112 -[[image:invitetothisroom.png||width="1000"]]
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.
113 113  
144 +[[image:addroom3.png||height="673" width="563"]]
114 114  
115 -The invitation will appear in the matrix chat window and must be accepted.
116 116  
117 -[[image:maxmustereinladungaccept.png||width="1000"]]
147 +== Invite People into the chat ==
118 118  
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.
119 119  
120 -=== invite to the private chat ===
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.
121 121  
122 122  
123 -**Requirement**: The member which is been invited has registered once on the same TUM/ITO Matrix Server
154 +Click the button **Invite to this room** to invite people to the group chat
124 124  
125 -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.
156 +[[image:addroom4new.png||height="571" width="553"]]
126 126  
127 127  
159 +If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface.
128 128  
129 -[[image:startchat1.png||width="1000"]]
161 +[[image:startchat1.png||height="177" width="555"]]
130 130  
163 +Enter the following Matrix ID's in the opened window:
131 131  
132 -Enter followings in the opened window:
165 +**For CIT Accounts**: e.g. @musterma:cit.tum.de
133 133  
134 -**For ITO Accounts**: e.g. @musterma:cit.tum.de
167 +(% class="box infomessage" %)
168 +(((
169 +@CIT-ID:cit.tum.de
170 +)))
135 135  
136 -{{{@cit.tum-ID:cit.tum.de
137 -
138 -}}}
139 -
140 140  **For TUM Accounts: **e.g. @lr89rbg:tum.de
141 141  
142 -{{{ @lrz-Kennung:tum.de
174 +(% class="box infomessage" %)
175 +(((
176 + @LRZ-ID:tum.de
177 +)))
143 143  
144 -}}}
179 +**For other Accounts: ** e.g. @musterma:matrix.org
145 145  
181 +(% class="box infomessage" %)
182 +(((
183 + @username:domain
184 +)))
146 146  
147 -and send the invitation to the e-mail address of the person to be invited, that means to the ITO(cit.tum) or TUM email address.
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.
148 148  
149 -[[image:invitepeople1.png||width="1000"]]
150 -
151 -
152 -[[image:invitepeople2.png||width="1000"]]
153 -
154 -
155 -The invitation will appear in the element chat window and must be accepted.
156 -
157 -[[image:invitepeople.png||width="1000"]]
158 -
159 -
160 -----
188 +[[image:invitetotestraum.png||height="309" width="548"]]