Changes for page Matrix
Last modified by Stefan Schwalb on 2023/08/28 20:39
From version 40.1
edited by Stefan Schwalb
on 2023/08/28 20:39
on 2023/08/28 20:39
Change comment:
There is no comment for this version
To version 32.1
edited by Aysegül Omus
on 2023/08/25 19:54
on 2023/08/25 19:54
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. schwalb1 +XWiki.kahraman - Content
-
... ... @@ -1,120 +1,191 @@ 1 1 {{toc/}} 2 2 3 += Establishing a Matrix Chat = 3 3 4 -= What is Matrix? = 5 5 6 +== What is Matrix? == 6 6 7 -[[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]] 8 8 9 +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. 9 9 10 - [[Matrix>>https://matrix.org/]]is achatmverysimilarE-Mail,but instantaneousand secure.11 +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. 11 11 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 -))) 13 +You can use either the desktop version or the web interface of matrix. 21 21 22 -So people have their **account on one server** but can write messages **to anyone on other servers**. 23 - 15 +== Sign in == 24 24 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. 17 +=== Sign in to the desktop version === 28 28 29 -== Home Server == 30 30 31 - Messagesed andsyncedbetweenhomeservers.20 +[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows. 32 32 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: 22 +[[image:matrixdownload.png||height="284" width="575"]] 35 35 36 -* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de 37 -* **matrix.tum.de** for TUM accounts: @username:tum.de 38 38 39 -You only need to use one account and can communicate with any other homeserver of the world. 40 40 41 -If you don'thave a CIT or TUMaccount, you canusea**public**homeserverinstead:26 +If you have a CIT or TUM Account, you can sign in wit your login data. 42 42 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/]] 🤩 28 +(% class="wikigeneratedid" %) 29 +For this you need the following homeserver: 46 46 47 -To use your home server, you have to **use a client** that communicates with your homeserver. 31 +(% class="box infomessage" %) 32 +((( 33 +CIT homeserver: matrix.cit.tum.de 34 +))) 48 48 49 -== Clients == 36 +(% class="box infomessage" %) 37 +((( 38 +TUM homeserver: matrix.tum.de 39 +))) 50 50 51 -[[ Element>>https://element.io/]] isurclientof choice.41 +[[image:elementdesktopversionlogineng.png||height="745" width="558"]] 52 52 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]] 43 +(% class="wikigeneratedid" %) 44 +[[image:signinediteng.png||height="606" width="557"]] 58 58 59 59 (% class="wikigeneratedid" %) 60 - Makesurehe **homeserver is setcorrectly**toyour provider!47 +[[image:desktopelementengcit2.png||height="609" width="556"]] 61 61 62 -(% class="box infomessage" %) 49 + 50 +(% class="wikigeneratedid" %) 51 +And the login data as follow: 52 + 53 +(% class="wikigeneratedid" %) 54 +CIT: 55 + 56 +(% class="box" %) 63 63 ((( 64 - **CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)**Password**: CIT Password58 +username: CIT-ID (without @cit.tum.de) 65 65 ))) 66 66 67 -(% class="box infomessage" %)61 +(% class="box" %) 68 68 ((( 69 - **TUM: Homeserver**: matrix.tum.de **Username**:LRZ-ID (without @mytum.de or @tum.de)**Password**: LRZ/TUM Password63 +Password: cit.tum Password 70 70 ))) 71 71 66 +(% class="wikigeneratedid" %) 67 +TUM: 72 72 73 -== Using Element for Matrix == 69 +(% class="box" %) 70 +((( 71 +username: LRZ-ID (without @mytum.de or @tum.de) 72 +))) 74 74 74 +(% class="box" %) 75 +((( 76 +Password: LRZ/TUM Password 77 +))) 75 75 76 -Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎 79 +(% class="wikigeneratedid" %) 80 +[[image:desktopelementengcit3.png||height="522" width="582"]] 77 77 78 -You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world. 79 79 80 80 81 -= Invitation ofTUMUsers=84 +=== Sign in to the web interface === 82 82 83 -When inviting TUM or CIT users to a chat, just enter the following Matrix IDs: 84 84 85 - **For CITAccounts**:87 + 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]] . 86 86 87 -(% class="box infomessage" %) 89 + 90 +==== With TUM login data ==== 91 + 92 + 93 +(% class="box" %) 88 88 ((( 89 - @CIT-ID:cit.tum.de(e.g.@cooluser:cit.tum.de)95 +Webpage: https:~/~/matrix.tum.de 90 90 ))) 91 91 92 -**For TUM Accounts:** 98 +(% class="box" %) 99 +((( 100 +username: LRZ-ID (without @mytum.de or @tum.de) 101 +))) 93 93 94 -(% class="box infomessage" %)103 +(% class="box" %) 95 95 ((( 96 - @LRZ-ID:tum.de(e.g. @ga42lol:tum.de)105 +Password: LRZ/TUM Password 97 97 ))) 98 98 99 - **For other Accounts: **e.g.@musterma:matrix.org108 +[[image:tumaccountlogineng1.png||height="329" width="582"]] 100 100 101 -(% class="box infomessage" %) 110 + 111 +[[image:tumaccountlogineng2n.png||height="357" width="581"]] 112 + 113 + 114 + 115 +==== With CIT login data ==== 116 + 117 +(% class="box" %) 102 102 ((( 103 - @username:domain119 +Webpage: https:~/~/matrix.cit.tum.de 104 104 ))) 105 105 106 -The invitation will then appear in the Matrix client of the just-added user and must be accepted. 122 +(% class="box" %) 123 +((( 124 +username: CIT-ID (without @cit.tum.de) 125 +))) 107 107 108 -**Search for User Names** 127 +(% class="box" %) 128 +((( 129 +Password: cit.tum Password 130 +))) 109 109 110 -To add a user to the user directory, he must become a member of a public chat room on the server, e.g. [[https:~~/~~/matrix.to/#/#announcements:tum.de>>https://matrix.to/#/#announcements:tum.de]] on matrix.tum.de, or share a private chat. Only after that his name will be displayed in the search field for persons. 111 111 112 - = SecureBackup =133 +[[image:Screenshot 2023-08-23 at 18.16.21.png||height="446" width="573"]] 113 113 114 -Since end-to-end encryption stores decryption **keys only on clients** (the "end"), logging out of the last client would mean loosing all messages. 115 115 116 - Matrixallows to create a encryptedbackupofthe decryptionkeys onyourhomeserver-witha separate passphrase.136 +[[image:rbgaccountlogineng2.png||height="353" width="569"]] 117 117 118 - Matrixwillask youto setup your secure backup,andwillrequest the passwordforthe backup keys if needed.138 +== Create a new chat room == 119 119 120 -More information is in the [[official documentation about private chats>>https://matrix.org/docs/chat_basics/private-group-chat/]] 🤓 140 +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. 141 + 142 +[[image:addroom1new.png||height="284" width="567"]] 143 + 144 + 145 +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. 146 + 147 +[[image:addroom3.png||height="673" width="563"]] 148 + 149 + 150 +== Invite People into the chat == 151 + 152 +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. 153 + 154 +**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. 155 + 156 + 157 +Click the button **Invite to this room** to invite people to the group chat. 158 + 159 +[[image:addroom4new.png||height="571" width="553"]] 160 + 161 + 162 +If you want to chat with a member privatly, click on the **+-Button** beside **People** in the program or on the web interface. 163 + 164 +[[image:startchat1.png||height="177" width="555"]] 165 + 166 +Enter the following Matrix ID's in the opened window: 167 + 168 +**For CIT Accounts**: e.g. @musterma:cit.tum.de 169 + 170 +(% class="box infomessage" %) 171 +((( 172 +@CIT-ID:cit.tum.de 173 +))) 174 + 175 +**For TUM Accounts: **e.g. @lr89rbg:tum.de 176 + 177 +(% class="box infomessage" %) 178 +((( 179 + @LRZ-ID:tum.de 180 +))) 181 + 182 +**For other Accounts: ** e.g. @musterma:matrix.org 183 + 184 +(% class="box infomessage" %) 185 +((( 186 + @username:domain 187 +))) 188 + 189 +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. 190 + 191 +[[image:invitetotestraum.png||height="309" width="548"]]