Wiki source code of Matrix
Last modified by Aysegül Omus on 2023/08/21 16:41
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | {{toc/}} | ||
2 | |||
3 | |||
4 | = What is Matrix? = | ||
5 | |||
6 | |||
7 | [[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]] | ||
8 | |||
9 | |||
10 | [[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure. | ||
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 | ))) | ||
21 | |||
22 | So people have their **account on one server** but can write messages **to anyone on other servers**. | ||
23 | |||
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. | ||
28 | |||
29 | == Home Server == | ||
30 | |||
31 | Messages are stored and synced between home servers. | ||
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: | ||
35 | |||
36 | * **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de | ||
37 | * **matrix.tum.de** for TUM accounts: @username:tum.de | ||
38 | |||
39 | You only need to use one account and can communicate with any other homeserver of the world. | ||
40 | |||
41 | If you don't have a CIT or TUM account, you can use a **public** homeserver instead: | ||
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/]] 🤩 | ||
46 | |||
47 | To use your home server, you have to **use a client** that communicates with your homeserver. | ||
48 | |||
49 | == Clients == | ||
50 | |||
51 | [[Element>>https://element.io/]] is our client of choice. | ||
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]] | ||
58 | |||
59 | (% class="wikigeneratedid" %) | ||
60 | Make sure the **home server is set correctly** to your provider! | ||
61 | |||
62 | (% class="box infomessage" %) | ||
63 | ((( | ||
64 | **CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de) **Password**: CIT Password | ||
65 | ))) | ||
66 | |||
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 | ))) | ||
71 | |||
72 | |||
73 | == Using Element for Matrix == | ||
74 | |||
75 | |||
76 | Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎 | ||
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 | |||
80 | |||
81 | = Invitation of TUM Users = | ||
82 | |||
83 | When inviting TUM or CIT users to a chat, just enter the following Matrix IDs: | ||
84 | |||
85 | **For CIT Accounts**: | ||
86 | |||
87 | (% class="box infomessage" %) | ||
88 | ((( | ||
89 | @CIT-ID:cit.tum.de (e.g. @cooluser:cit.tum.de) | ||
90 | ))) | ||
91 | |||
92 | **For TUM Accounts:** | ||
93 | |||
94 | (% class="box infomessage" %) | ||
95 | ((( | ||
96 | @LRZ-ID:tum.de (e.g. @ga42lol:tum.de) | ||
97 | ))) | ||
98 | |||
99 | **For other Accounts: ** e.g. @musterma:matrix.org | ||
100 | |||
101 | (% class="box infomessage" %) | ||
102 | ((( | ||
103 | @username:domain | ||
104 | ))) | ||
105 | |||
106 | The invitation will then appear in the Matrix client of the just-added user and must be accepted. | ||
107 | |||
108 | **Search for User Names** | ||
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 | |||
112 | = Secure Backup = | ||
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 | |||
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/]] 🤓 |