Wiki source code of Matrix
Last modified by Stefan Schwalb on 2023/08/28 20:39
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
433.1 | 1 | {{toc/}} |
![]() |
1.1 | 2 | |
3 | |||
![]() |
438.1 | 4 | = What is Matrix? = |
![]() |
1.1 | 5 | |
6 | |||
![]() |
433.1 | 7 | [[image:matrix-element-uidemo.png||alt="Matrix user interface demo" height="641" width="892"]] |
![]() |
1.1 | 8 | |
9 | |||
![]() |
438.1 | 10 | [[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure. |
![]() |
1.1 | 11 | |
![]() |
438.1 | 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 | ||
![]() |
433.1 | 14 | ** ((( |
![]() |
438.1 | 15 | For example {{code language="none"}}@someprofessor:tum.de{{/code}} can communicate with {{code language="none"}}@someresearcher:lmu.de{{/code}}! |
![]() |
245.1 | 16 | ))) |
![]() |
433.1 | 17 | * ((( |
![]() |
438.1 | 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. | ||
![]() |
257.1 | 20 | ))) |
![]() |
1.1 | 21 | |
![]() |
438.1 | 22 | So people have their **account on one server** but can write messages **to anyone on other servers**. |
![]() |
433.1 | 23 | |
![]() |
1.1 | 24 | |
![]() |
438.1 | 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. | ||
![]() |
1.1 | 28 | |
![]() |
433.1 | 29 | == Home Server == |
![]() |
1.1 | 30 | |
![]() |
438.1 | 31 | Messages are stored and synced between home servers. |
![]() |
1.1 | 32 | |
![]() |
438.1 | 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: | ||
![]() |
1.1 | 35 | |
![]() |
438.1 | 36 | * **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de |
37 | * **matrix.tum.de** for TUM accounts: @username:tum.de | ||
![]() |
1.1 | 38 | |
![]() |
438.1 | 39 | You only need to use one account and can communicate with any other homeserver of the world. |
![]() |
1.1 | 40 | |
![]() |
438.1 | 41 | If you don't have a CIT or TUM account, you can use a **public** homeserver instead: |
![]() |
1.1 | 42 | |
![]() |
433.1 | 43 | * matrix.org: [[https:~~/~~/app.element.io/#/register>>https://app.element.io/#/register]] |
![]() |
438.1 | 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/]] 🤩 | ||
![]() |
1.1 | 46 | |
![]() |
438.1 | 47 | To use your home server, you have to **use a client** that communicates with your homeserver. |
![]() |
1.1 | 48 | |
![]() |
433.1 | 49 | == Clients == |
![]() |
1.1 | 50 | |
![]() |
438.1 | 51 | [[Element>>https://element.io/]] is our client of choice. |
![]() |
1.1 | 52 | |
![]() |
438.1 | 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: | ||
![]() |
433.1 | 55 | ** [[matrix.cit.tum.de>>https://matrix.cit.tum.de]] |
56 | ** [[matrix.tum.de>>https://matrix.tum.de]] | ||
![]() |
438.1 | 57 | * [[On your smartphone>>https://element.io/download]] |
![]() |
1.1 | 58 | |
![]() |
433.1 | 59 | (% class="wikigeneratedid" %) |
![]() |
438.1 | 60 | Make sure the **home server is set correctly** to your provider! |
![]() |
1.1 | 61 | |
![]() |
433.1 | 62 | (% class="box infomessage" %) |
![]() |
245.1 | 63 | ((( |
![]() |
438.1 | 64 | **CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de) **Password**: CIT Password |
![]() |
245.1 | 65 | ))) |
![]() |
1.1 | 66 | |
![]() |
259.1 | 67 | (% class="box infomessage" %) |
68 | ((( | ||
![]() |
438.1 | 69 | **TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de) **Password**: LRZ/TUM Password |
![]() |
259.1 | 70 | ))) |
![]() |
1.1 | 71 | |
72 | |||
![]() |
438.1 | 73 | == Using Element for Matrix == |
![]() |
1.1 | 74 | |
75 | |||
![]() |
438.1 | 76 | Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎 |
![]() |
1.1 | 77 | |
![]() |
438.1 | 78 | You can create **personal chats**, **group chats**, and **spaces** for bundling multiple chatrooms to communicate with any other Matrix user in the world. |
![]() |
1.1 | 79 | |
80 | |||
![]() |
438.1 | 81 | = Invitation of TUM Users = |
![]() |
1.1 | 82 | |
![]() |
438.1 | 83 | When inviting TUM or CIT users to a chat, just enter the following Matrix IDs: |
![]() |
1.1 | 84 | |
![]() |
438.1 | 85 | **For CIT Accounts**: |
![]() |
1.1 | 86 | |
![]() |
433.1 | 87 | (% class="box infomessage" %) |
![]() |
245.1 | 88 | ((( |
![]() |
438.1 | 89 | @CIT-ID:cit.tum.de (e.g. @cooluser:cit.tum.de) |
![]() |
245.1 | 90 | ))) |
![]() |
1.1 | 91 | |
![]() |
438.1 | 92 | **For TUM Accounts:** |
![]() |
1.1 | 93 | |
![]() |
245.1 | 94 | (% class="box infomessage" %) |
95 | ((( | ||
![]() |
438.1 | 96 | @LRZ-ID:tum.de (e.g. @ga42lol:tum.de) |
![]() |
245.1 | 97 | ))) |
![]() |
1.1 | 98 | |
![]() |
438.1 | 99 | **For other Accounts: ** e.g. @musterma:matrix.org |
![]() |
1.1 | 100 | |
![]() |
245.1 | 101 | (% class="box infomessage" %) |
102 | ((( | ||
![]() |
438.1 | 103 | @username:domain |
![]() |
245.1 | 104 | ))) |
![]() |
1.1 | 105 | |
![]() |
438.1 | 106 | The invitation will then appear in the Matrix client of the just-added user and must be accepted. |
![]() |
1.1 | 107 | |
![]() |
438.1 | 108 | **Search for User Names** |
![]() |
1.1 | 109 | |
![]() |
438.1 | 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. |
![]() |
434.1 | 111 | |
![]() |
438.1 | 112 | = Secure Backup = |
![]() |
1.1 | 113 | |
![]() |
438.1 | 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. |
![]() |
1.1 | 115 | |
![]() |
438.1 | 116 | Matrix allows to create a encrypted backup of the decryption keys on your homeserver - with a separate passphrase. |
![]() |
1.1 | 117 | |
![]() |
438.1 | 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/]] 🤓 |