Changes for page Matrix
Last modified by Stefan Schwalb on 2023/08/28 20:39
From version 4.1
edited by Aysegül Omus
on 2023/08/21 16:37
on 2023/08/21 16:37
Change comment:
There is no comment for this version
To version 37.1
edited by Jonas Jelten
on 2023/08/28 17:07
on 2023/08/28 17:07
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. kahraman1 +XWiki.jelten - Content
-
... ... @@ -1,271 +1,117 @@ 1 - = Establishing a Matrix Chat =1 +{{toc/}} 2 2 3 3 4 +== What is Matrix? == 4 4 5 -(% class="wikitoc" %) 6 -* [[Establishing a Matrix Chat>>path:#HEstablishingaMatrixChat]] 7 -** [[Log in>>path:#HLogin]] 8 -*** [[Log in to the web interface with TUM login data>>path:#HLogintothewebinterfacewithTUMlogindata]] 9 -*** [[Log in to the web interface with cit.tum login data>>path:#HLogintothewebinterfacewithcit.tumlogindata]] 10 -** [[Create new chat room>>path:#HCreatenewchatroom]] 11 -*** [[Explore rooms>>path:#HExplorerooms]] 12 -** [[Invite into the chat room>>path:#HInviteintothechatroom]] 13 -** [[private chat>>path:#Hprivatechat]] 14 -** [[keys for encrypted rooms>>path:#Hkeysforencryptedrooms]] 15 -** [[User Settings>>path:#HUserSettings]] 16 -*** [[All Settings>>path:#HAllSettings]] 17 -**** [[General>>path:#HGeneral]] 18 -**** [[Appearance>>path:#HAppearance]] 19 -**** [[Flair>>path:#HFlair]] 20 -**** [[Notifications>>path:#HNotifications]] 21 -**** [[Preferences>>path:#HPreferences]] 22 -**** [[Voice & Video>>path:#HVoice26Video]] 23 -**** [[Security and Privacy>>path:#HSecurityandPrivacy]] 24 -**** [[Help & About>>path:#HHelp26About]] 25 -** [[Settings for People>>path:#HSettingsforPeople]] 26 -*** [[General>>path:#HGeneral-1]] 27 -**** [[Show options>>path:#HShowoptions]] 28 -**** [[Start chat>>path:#HStartchat]] 29 -*** [[Room Settings>>path:#HRoomSettings]] 30 -*** [[Share room>>path:#HShareroom]] 31 -*** [[Manage Integrations>>path:#HManageIntegrations]] 32 -*** [[Search>>path:#HSearch]] 33 -*** [[Show/hide members>>path:#HShow2Fhidemembers]] 34 -*** [[Files>>path:#HFiles]] 35 -*** [[Notifications>>path:#HNotifications-1]] 36 -*** [[Room options>>path:#HRoomoptions]] 37 -*** [[Notification options>>path:#HNotificationoptions]] 38 -** [[Settings for rooms>>path:#HSettingsforrooms]] 39 -*** [[General>>path:#HGeneral-2]] 40 -**** [[Show options>>path:#HShowoptions-1]] 41 -**** [[Create new room>>path:#HCreatenewroom]] 42 -*** [[Room Options>>path:#HRoomOptions]] 43 -*** [[Share room>>path:#HShareroom-1]] 44 -*** [[Manage Integrations>>path:#HManageIntegrations-1]] 45 -*** [[Search>>path:#HSearch-1]] 46 -*** [[Show/hide members>>path:#HShow2Fhidemembers-1]] 47 -*** [[Files>>path:#HFiles-1]] 48 -*** [[Notifications>>path:#HNotifications-2]] 49 -*** [[Room options>>path:#HRoomoptions-1]] 50 -*** [[Notification options>>path:#HNotificationoptions-1]] 51 -* [[Important KB-Links (the website is only available in MWN Network):>>path:#HImportantKB-Links28thewebsiteisonlyavailableinMWNNetwork29:]] 52 52 53 -There are two Matrix-Servers: 54 - 1 matrix.tum.de (LRZ-ID) 55 - 1 matrix.cit.tum.de (ITO-ID) 7 +[[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]] 56 56 57 -You can log in any of them with the appropriate ID and password. 58 -The Matrix Server is available as web but also as client. It can be found as web interface under the following links: 59 -[[matrix.cit.tum.de (ITOID)>>url:https://matrix.cit.tum.de/#/welcome]] 60 60 10 +[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure. 61 61 62 -[[matrix.tum.de (LRZ-TUM-ID)>>url:https://matrix.tum.de/#/welcome]] 12 +* You need to register an account at a provider (e.g. tum.de, or lmu.de) 13 +* Whatever your provider is, you can talk to people using other providers 14 +** ((( 15 +For example {{code language="none"}}@someprofessor:tum.de{{/code}} can communicate with {{code language="none"}}@someresearcher:lmu.de{{/code}}! 16 +))) 17 +* ((( 18 +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! 19 +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. 20 +))) 63 63 22 +So people have their **account on one server** but can write messages **to anyone on other servers**. 23 + 64 64 65 -[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows. 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. 26 +All your messages are **synced** between all your devices - web clients, desktop clients, smartphone apps. 27 +For additional security, encryption keys of contacts can be verified and then stored as trusted. 66 66 29 +== Home Server == 67 67 68 - [[image:Informatik/Helpdesk/MatrixChat/WebHome/elementdriver.png?width=1000&rev=1.2||alt="elementdriver.png" width="1000"]]31 +Messages are stored and synced between home servers. 69 69 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: 70 70 71 -== Log in == 36 +* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de 37 +* **matrix.tum.de** for TUM accounts: @username:tum.de 72 72 39 +You only need to use one account and can communicate with any other homeserver of the world. 73 73 41 +If you don't have a CIT or TUM account, you can use a **public** homeserver instead: 74 74 75 -=== Log in to the web interface with TUM login data === 43 +* matrix.org: [[https:~~/~~/app.element.io/#/register>>https://app.element.io/#/register]] 44 +* or any other homeserver [[https:~~/~~/joinmatrix.org/servers/>>https://joinmatrix.org/servers/]] 45 +* or, [[host your own homeserver>>https://matrix-org.github.io/synapse/latest/]] 🤩 76 76 47 +To use your home server, you have to **use a client** that communicates with your homeserver. 77 77 49 +== Clients == 78 78 79 - {{{Webseite:https://matrix.tum.de51 +[[Element>>https://element.io/]] is our client of choice. 80 80 81 -ID: LRZ-ID (without @mytum.de or @tum.de) 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]] 82 82 83 -Password: LRZ/TUM Password 59 +(% class="wikigeneratedid" %) 60 +Make sure the **home server is set correctly** to your provider! 84 84 62 +(% class="box infomessage" %) 63 +((( 64 +**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de) **Password**: CIT Password 65 +))) 85 85 86 -}}} 67 +(% class="box infomessage" %) 68 +((( 69 +**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de) **Password**: LRZ/TUM Password 70 +))) 87 87 88 88 73 +== Using Element for Matrix == 89 89 90 -[[image:matrixrbgTUM.png?width=1000&rev=1.2||alt="matrixrbgTUM.png" width="1000"]] 91 91 76 +Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎 92 92 78 +You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world. 93 93 94 94 81 +== Invitation of TUM Users == 95 95 96 - [[image:matrixanmeldentum.png?width=1000&rev=1.2||alt="matrixanmeldentum.png"width="1000"]]83 +When inviting TUM or CIT users to a chat, just enter the following Matrix IDs: 97 97 85 +**For CIT Accounts**: 98 98 87 +(% class="box infomessage" %) 88 +((( 89 +@CIT-ID:cit.tum.de (e.g. @cooluser:tum.de) 90 +))) 99 99 100 - 101 - 102 - 103 -=== Log in to the web interface with cit.tum login data === 104 - 105 -{{{Webseite: https://matrix.in.tum.de 106 - 107 -ID: ITO(cit.tum)-ID (without @cit.tum.de) 108 - 109 -Password: cit.tum Password 110 - 111 -}}} 112 - 113 - 114 - 115 - 116 - 117 -[[image:Informatik/Helpdesk/MatrixChat/WebHome/elemtrbgin.png?width=1000&rev=1.2||alt="elemtrbgin.png" width="1000"]] 118 - 119 - 120 - 121 -[[image:Informatik/Helpdesk/MatrixChat/WebHome/matrixanmeldenIntum.png?width=1000&rev=1.2||alt="matrixanmeldenIntum.png" width="1000"]] 122 - 123 - 124 - 125 - 126 - 127 ----- 128 - 129 -== Create new chat room == 130 - 131 - 132 -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 - 134 - 135 - 136 -[[image:/bin/download/Informatik/Helpdesk/MatrixChat/WebHome/createroom%2B.png?width=1000||alt="createroom+.png" width="1000"]] 137 - 138 - 139 - 140 -[[image:/bin/download/Informatik/Helpdesk/MatrixChat/WebHome/createroom2.png?width=1000&rev=1.2||alt="createroom2.png" width="1000"]] 141 - 142 - 143 - 144 - 145 - 146 - 147 -=== Explore rooms === 148 - 149 - 150 -It is also possible to make the room public. Then the chat room is visible to others and can be found via **Explore rooms**. This setting can be changed later. 151 - 152 - 153 - 154 -[[image:/bin/download/Informatik/Helpdesk/MatrixChat/WebHome/explorerooms.png?width=1000&rev=1.2||alt="explorerooms.png" width="1000"]] 155 - 156 - 157 - 158 - 159 - 160 -[[image:/bin/download/Informatik/Helpdesk/MatrixChat/WebHome/explorerooms2join.png?width=1000&rev=1.2||alt="explorerooms2join.png" width="1000"]] 161 - 162 - 163 - 164 - 165 - 166 - 167 -The chat room **Test-RBG** is private, so it is not visible to others and participants can only join the room by invitation. 168 - 169 - 170 - 171 -[[image:/bin/download/Informatik/Helpdesk/MatrixChat/WebHome/createroomtestrbg.png?width=1000&rev=1.2||alt="createroomtestrbg.png" width="1000"]] 172 - 173 - 174 - 175 - 176 - 177 - 178 -== Invite into the chat room == 179 - 180 - 181 - 182 -**Requirement**: The member which is been invited has registered once on the same TUM/ITO Matrix Server 183 - 184 -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. 185 - 186 - 187 - 188 -[[image:/bin/download/Informatik/Helpdesk/MatrixChat/WebHome/invitetothisroom1.png?width=1000&rev=1.2||alt="invitetothisroom1.png" width="1000"]] 189 - 190 - 191 - 192 -Enter followings in the opened window: 193 - 194 -**For in.tum or ma.tum Accounts**: e.g. @musterma:cit.tum.de 195 - 196 -{{{@cit.tum-ID:cit.tum.de 197 - 198 -}}} 199 - 200 200 **For TUM Accounts:** 201 201 202 -{{{ @lrz-Kennung:tum.de 94 +(% class="box infomessage" %) 95 +((( 96 + @LRZ-ID:tum.de (e.g. @ga42lol:tum.de) 97 +))) 203 203 204 - }}}99 +**For other Accounts: ** e.g. @musterma:matrix.org 205 205 101 +(% class="box infomessage" %) 102 +((( 103 + @username:domain 104 +))) 206 206 207 - and send the invitationtothe e-mailaddressof thepersontobeinvited,thatmeansotheITO(cit.tum) or TUMemail address.106 +The invitation will then appear in the Matrix client of the just-added user and must be accepted. 208 208 209 209 109 +== Secure Backup == 210 210 211 - [[image:/bin/download/Informatik/Helpdesk/MatrixChat/WebHome/invitetothisroom.png?width=1000&rev=1.2||alt="invitetothisroom.png"width="1000"]]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. 212 212 113 +Matrix allows to create a encrypted backup of the decryption keys on your homeserver - with a separate passphrase. 213 213 115 +Matrix will ask you to set up your secure backup, and will request the password for the backup keys if needed. 214 214 215 - 216 - 217 - 218 -The invitation will appear in the element chat window and must be accepted. 219 - 220 - 221 - 222 -[[image:Informatik/Helpdesk/MatrixChat/WebHome/maxmustereinladungaccept.png?width=1000&rev=1.2||alt="maxmustereinladungaccept.png" width="1000"]] 223 - 224 - 225 - 226 - 227 -== private chat == 228 - 229 - 230 -**Requirement**: The member which is been invited has registered once on the same TUM/ITO Matrix Server 231 - 232 -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. 233 - 234 - 235 - 236 -[[image:Informatik/Helpdesk/MatrixChat/WebHome/startchat1.png?width=1000&rev=1.2||alt="startchat1.png" width="1000"]] 237 - 238 - 239 - 240 - 241 - 242 - 243 -Enter followings in the opened window: 244 - 245 -**For cit.tum Accounts**: e.g. @musterma:cit.tum.de 246 - 247 -{{{@cit.tum-ID:cit.tum.de 248 - 249 -}}} 250 - 251 -**For TUM Accounts:** 252 - 253 -{{{ @lrz-Kennung:tum.de 254 - 255 -}}} 256 - 257 - 258 -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. 259 - 260 -[[image:Informatik/Helpdesk/MatrixChat/WebHome/invitepeople1.png?width=1000&rev=1.2||alt="invitepeople1.png" width="1000"]] 261 - 262 - 263 -[[image:/Informatik/Helpdesk/MatrixChat/WebHome/invitepeople2.png?width=1000&rev=1.2||alt="invitepeople2.png" width="1000"]] 264 - 265 - 266 -The invitation will appear in the element chat window and must be accepted. 267 - 268 -[[image:/invitepeople.png?width=1000&rev=1.2||alt="invitepeople.png" width="1000"]] 269 - 270 - 271 ----- 117 +More information is in the [[official documentation about private chats>>https://matrix.org/docs/chat_basics/private-group-chat/]] 🤓