Wiki source code of Matrix

Last modified by Stefan Schwalb on 2023/08/28 20:39

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/]] 🤓

Wiki source code of Matrix

Navigation