Changes for page Matrix

Last modified by Stefan Schwalb on 2023/08/28 20:39
From version 21.1
edited by Aysegül Omus
on 2023/08/23 00:56
Change comment: There is no comment for this version
To version 39.1
edited by Claus von Rücker
on 2023/08/28 18:53
Change comment: added Search for User Names

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kahraman
1 +XWiki.rueckerc
Content
... ... @@ -1,153 +1,99 @@
1 1  {{toc/}}
2 2  
3 3  
4 -= Establishing a Matrix Chat =
4 += What is Matrix? =
5 5  
6 -You can log in to Matrix with ITO, TUM email addresses or create an account with a different email address and use it to log in and chat with the people who have once logged in to Matrix.
7 7  
8 -There are two Matrix servers of ITO. The Matrix servers are available as web but also as client. It can be found as web interface under the following links:
9 -
7 +[[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]]
10 10  
11 - 1 [[matrix.cit.tum.de (ITO- ID)>>url:https://matrix.cit.tum.de/#/welcome]]
12 - 1 [[matrix.tum.de (LRZ-TUM-ID)>>url:https://matrix.tum.de/#/welcome]]
13 13  
14 -You can log in any of them with the appropriate ID and password.
10 +[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
15 15  
16 -
17 -If you want to use your another email address you can create an account on [[this website>>https://app.element.io/?pk_vid=16927438994f9401#/welcome]] and then login to Matrix.
18 -
19 -And[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
20 -
21 -
22 -[[image:matrixdownload.png||height="284" width="575"]]
23 -
24 -
25 -== Log in ==
26 -
27 -
28 -=== Log in to the web interface with TUM login data ===
29 -
30 -
31 -(% class="box" %)
32 -(((
33 -Webpage: https:~/~/matrix.tum.de
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}}!
34 34  )))
35 -
36 -(% class="box" %)
37 -(((
38 -ID: LRZ-ID (without @mytum.de or @tum.de)
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.
39 39  )))
40 40  
41 -(% class="box" %)
42 -(((
43 -Password: LRZ/TUM Password
44 -)))
22 +So people have their **account on one server** but can write messages **to anyone on other servers**.
23 +
45 45  
46 -[[image:tumaccountlogineng1.png||height="329" width="582"]]
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.
47 47  
29 +== Home Server ==
48 48  
49 -[[image:tumaccountlogineng2n.png||height="362" width="589"]]
31 +Messages are stored and synced between home servers.
50 50  
51 -=== Log in to the web interface with cit.tum login data ===
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:
52 52  
53 -(% class="box" %)
54 -(((
55 -Webpage: https:~/~/matrix.cit.tum.de
56 -)))
36 +* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
37 +* **matrix.tum.de** for TUM accounts: @username:tum.de
57 57  
58 -(% class="box" %)
59 -(((
60 -ID: ITO-ID (without @cit.tum.de)
61 -)))
39 +You only need to use one account and can communicate with any other homeserver of the world.
62 62  
63 -(% class="box" %)
64 -(((
65 -Password: cit.tum Password
66 -)))
41 +If you don't have a CIT or TUM account, you can use a **public** homeserver instead:
67 67  
68 -[[image:rbgaccountlogineng1.png||height="369" width="601"]]
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/]] 🤩
69 69  
47 +To use your home server, you have to **use a client** that communicates with your homeserver.
70 70  
71 -[[image:rbgaccountlogineng2.png||height="377" width="608"]]
49 +== Clients ==
72 72  
51 +[[Element>>https://element.io/]] is our client of choice.
73 73  
74 -== Create new chat room ==
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]]
75 75  
76 -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.
59 +(% class="wikigeneratedid" %)
60 +Make sure the **home server is set correctly** to your provider!
77 77  
78 -[[image:addroom1.png||height="311" width="622"]]
79 -
80 -
81 -The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation.
82 -
83 -[[image:addroom3.png||height="738" width="617"]]
84 -
85 -
86 -== Invite into the chat room ==
87 -
88 -**Requirement**: The member which is been invited has registered once on the Matrix Server.
89 -
90 -**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.
91 -
92 -If you want to invite new members to the room, click the button **Invite to this room**.
93 -
94 -[[image:addroom4.png||height="636" width="616"]]
95 -
96 -
97 -Enter followings in the opened window:
98 -
99 -**For ITO Accounts**: e.g. @musterma:cit.tum.de
100 -
101 101  (% class="box infomessage" %)
102 102  (((
103 -@ITO-ID:cit.tum.de
64 +**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)  **Password**: CIT Password
104 104  )))
105 105  
106 -**For TUM Accounts: **e.g. @lr89rbg:tum.de
107 -
108 108  (% class="box infomessage" %)
109 109  (((
110 - @lrz-ID:tum.de
69 +**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de)  **Password**: LRZ/TUM Password
111 111  )))
112 112  
113 -**For other Accounts: ** e.g. @musterma:matrix.org
114 114  
115 -(% class="box infomessage" %)
116 -(((
117 - name, email address, username  @username:domain
118 -)))
73 +== Using Element for Matrix ==
119 119  
120 -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.
121 121  
76 +Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎
122 122  
123 -[[image:invitetotestroom.png||height="593" width="622"]]
78 +You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world.
124 124  
125 125  
126 -=== invite to the private chat ===
81 += Invitation of TUM Users =
127 127  
83 +When inviting TUM or CIT users to a chat, just enter the following Matrix IDs:
128 128  
129 -**Requirement**: The member which is been invited has registered once on the Matrix Server.
85 +**For CIT Accounts**:
130 130  
131 -
132 -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.
133 -
134 -[[image:startchat1.png||height="202" width="633"]]
135 -
136 -
137 -Enter followings in the opened window:
138 -
139 -**For ITO Accounts**: e.g. @musterma:cit.tum.de
140 -
141 141  (% class="box infomessage" %)
142 142  (((
143 -@ITO-ID:cit.tum.de
89 +@CIT-ID:cit.tum.de     (e.g. @cooluser:tum.de)
144 144  )))
145 145  
146 -**For TUM Accounts: **e.g. @lr89rbg:tum.de
92 +**For TUM Accounts:**
147 147  
148 148  (% class="box infomessage" %)
149 149  (((
150 - @lrz-ID:tum.de
96 + @LRZ-ID:tum.de     (e.g. @ga42lol:tum.de)
151 151  )))
152 152  
153 153  **For other Accounts: ** e.g. @musterma:matrix.org
... ... @@ -154,15 +154,21 @@
154 154  
155 155  (% class="box infomessage" %)
156 156  (((
157 - name, email address, username  @username:homeserver
103 + @username:domain
158 158  )))
159 159  
160 -and send the invitation to the e-mail address of the person to be invited. [[image:invitepeople1.png||height="298" width="687"]]
106 +The invitation will then appear in the Matrix client of the just-added user and must be accepted.
161 161  
108 +**Search for User Names**
162 162  
163 -The invitation will appear in the element chat window and must be accepted.
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.
164 164  
165 -[[image:invitepeople2.png||height="263" width="686"]]
112 += Secure Backup =
166 166  
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.
167 167  
168 -----
116 +Matrix allows to create a encrypted backup of the decryption keys on your homeserver - with a separate passphrase.
117 +
118 +Matrix will ask you to set up your secure backup, and will request the password for the backup keys if needed.
119 +
120 +More information is in the [[official documentation about private chats>>https://matrix.org/docs/chat_basics/private-group-chat/]] 🤓