Changes for page Matrix

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.jelten
	1	+XWiki.kahraman

Content

...	...	@@ -1,93 +1,165 @@
1	1	{{toc/}}
2	2
3	3
4		-== What is Matrix? ==
	4	+= Establishing a Matrix Chat =
5	5
6	6
7		-[[Matrix>>https://matrix.org/]] is a chat system very similar to E-Mail, but instantaneous and secure.
8	8
9		-* You need to register an account at a provider (e.g. tum.de, or lmu.de)
10		-* Whatever your provider is, you can talk to people using other providers
11		-** (((
12		-For example {{code language="none"}}@someprofessor:tum.de{{/code}} can communicate with {{code language="none"}}@someresearcher:lmu.de{{/code}}!
	8	+== what's matrix? ==
	9	+
	10	+
	11	+Matrix is a chat system very similar to email. 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.
	12	+
	13	+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.
	14	+
	15	+
	16	+
	17	+
	18	+you can use following ito or cit interface of Matrix chat if you have ITO or CIT account:
	19	+
	20	+
	21	+ 1 [[matrix.cit.tum.de (ITO- ID)>>url:https://matrix.cit.tum.de/#/welcome]]
	22	+ 1 [[matrix.tum.de (LRZ-TUM-ID)>>url:https://matrix.tum.de/#/welcome]]
	23	+
	24	+You can log in any of them with the appropriate ID and password.
	25	+
	26	+
	27	+if you don't have a CIT or TUM account, you can create a matrix account freely on [[https:~~/~~/app.element.io>>url:https://app.element.io/]]
	28	+
	29	+
	30	+And[[ Here>>url:https://element.io/get-started]] you can find installation for IOS, Android, Mac, Linux and Windows.
	31	+
	32	+
	33	+[[image:matrixdownload.png||height="284" width="575"]]
	34	+
	35	+
	36	+== Log in ==
	37	+
	38	+
	39	+=== Log in to the web interface with TUM login data ===
	40	+
	41	+
	42	+(% class="box" %)
	43	+(((
	44	+Webpage: https:~/~/matrix.tum.de
13	13	)))
14		-* (((
15		-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!
16		-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.
	46	+
	47	+(% class="box" %)
	48	+(((
	49	+ID: LRZ-ID (without @mytum.de or @tum.de)
17	17	)))
18	18
19		-So People have their **account on one server** but can write messages **to anyone on other servers**.
20		-
	52	+(% class="box" %)
	53	+(((
	54	+Password: LRZ/TUM Password
	55	+)))
21	21
22		-You can create[[ end-to-end encrypted>>https://en.wikipedia.org/wiki/End-to-end_encryption]] **personal or group chats** that are not stored and **not dependent on a central authority** like most other tools (MS Teams, WhatsApp, Zoom, ...).
23		-All your messages are **synced** between all your devices - web clients, desktop clients, smartphone apps.
24		-For additional security, encryption keys of contacts can be verified and then stored as trusted.
	57	+[[image:tumaccountlogineng1.png||height="329" width="582"]]
25	25
26		-== Home Server ==
27	27
28		-Messages are stored and synced between home servers.
	60	+[[image:tumaccountlogineng2n.png||height="362" width="589"]]
29	29
30		-A user typically has **one account** on one homeserver. You can use any homeserver of your choice - however [[ITO>>doc:CIT.ITO.WebHome]] offers two homeservers:
	62	+=== Log in to the web interface with cit.tum login data ===
31	31
32		-* **matrix.cit.tum.de** for CIT accounts: @username:cit.tum.de
33		-* **matrix.tum.de** for TUM accounts: @username:tum.de
	64	+(% class="box" %)
	65	+(((
	66	+Webpage: https:~/~/matrix.cit.tum.de
	67	+)))
34	34
35		-You only need to use one account and can communicate with any other homeserver of the world.
	69	+(% class="box" %)
	70	+(((
	71	+ID: ITO-ID (without @cit.tum.de)
	72	+)))
36	36
37		-If you don't have a CIT or TUM account, you can use a public homeserver instead:
	74	+(% class="box" %)
	75	+(((
	76	+Password: cit.tum Password
	77	+)))
38	38
39		-* matrix.org: [[https:~~/~~/app.element.io/#/register>>https://app.element.io/#/register]]
40		-* or any other homeserver [[https:~~/~~/joinmatrix.org/servers/>>https://joinmatrix.org/servers/]]
41		-* or, host your own homeserver :)
42	42
43		-To use your home server, you have to **use a client** that communicates with your homeserver.
	80	+[[image:Screenshot 2023-08-23 at 18.16.21.png||height="474" width="609"]]
44	44
45		-== Clients ==
46	46
47		-[[Element>>https://element.io/]] is our client of choice.
	83	+[[image:rbgaccountlogineng2.png||height="377" width="608"]]
48	48
49		-* [[Desktop Client>>https://element.io/download]] (easily provided in [[your Linux distribution of choice>>https://repology.org/project/element-desktop]])
50		-* as web client:
51		-** [[matrix.cit.tum.de>>https://matrix.cit.tum.de]]
52		-** [[matrix.tum.de>>https://matrix.tum.de]]
53		-* [[on your smartphone>>https://element.io/download]]
54	54
55		-(% class="wikigeneratedid" %)
56		-Make sure the **home server is set correctly** to your provider!
	86	+== Create new chat room ==
57	57
	88	+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.
	89	+
	90	+[[image:addroom1.png||height="311" width="622"]]
	91	+
	92	+
	93	+The chat room **TestRoom** is private, so it is not visible to others and participants can only join the room by invitation.
	94	+
	95	+[[image:addroom3.png||height="738" width="617"]]
	96	+
	97	+
	98	+== Invite into the chat room ==
	99	+
	100	+**Requirement**: The member which is been invited has registered once on the Matrix Server.
	101	+
	102	+**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.
	103	+
	104	+If you want to invite new members to the room, click the button **Invite to this room**.
	105	+
	106	+[[image:addroom4.png||height="636" width="616"]]
	107	+
	108	+
	109	+Enter followings in the opened window:
	110	+
	111	+**For ITO Accounts**: e.g. @musterma:cit.tum.de
	112	+
58	58	(% class="box infomessage" %)
59	59	(((
60		-**CIT: Homeserver**: matrix.cit.tum.de **Username**: CIT-ID (without @cit.tum.de)  **Password**: CIT Password
	115	+@ITO-ID:cit.tum.de
61	61	)))
62	62
	118	+**For TUM Accounts: **e.g. @lr89rbg:tum.de
	119	+
63	63	(% class="box infomessage" %)
64	64	(((
65		-**TUM: Homeserver**: matrix.tum.de **Username**: LRZ-ID (without @mytum.de or @tum.de)  **Password**: LRZ/TUM Password
	122	+ @lrz-ID:tum.de
66	66	)))
67	67
	125	+**For other Accounts: ** e.g. @musterma:matrix.org
68	68
69		-== Basic Usage of Element ==
	127	+(% class="box infomessage" %)
	128	+(((
	129	+ name, email address, username  @username:domain
	130	+)))
70	70
	132	+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.
71	71
72		-Follow [[the official guide>>https://matrix.org/docs/chat_basics/]] how to chat with Element 😎
73	73
	135	+[[image:invitetotestroom.png||height="593" width="622"]]
74	74
75		-=== Invitation of TUM Users ===
76	76
77		-When inviting TUM or CIT users to a chat, just enter the following Matrix IDs:
	138	+=== invite to the private chat ===
78	78
79		-**For CIT Accounts**:
80	80
	141	+**Requirement**: The member which is been invited has registered once on the Matrix Server.
	142	+
	143	+
	144	+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.
	145	+
	146	+[[image:startchat1.png||height="202" width="633"]]
	147	+
	148	+
	149	+Enter followings in the opened window:
	150	+
	151	+**For ITO Accounts**: e.g. @musterma:cit.tum.de
	152	+
81	81	(% class="box infomessage" %)
82	82	(((
83		-@CIT-ID:cit.tum.de     (e.g. @cooluser:tum.de)
	155	+@ITO-ID:cit.tum.de
84	84	)))
85	85
86		-**For TUM Accounts:**
	158	+**For TUM Accounts: **e.g. @lr89rbg:tum.de
87	87
88	88	(% class="box infomessage" %)
89	89	(((
90		- @LRZ-ID:tum.de     (e.g. @ga42lol:tum.de)
	162	+ @lrz-ID:tum.de
91	91	)))
92	92
93	93	**For other Accounts: ** e.g. @musterma:matrix.org
...	...	@@ -94,9 +94,15 @@
94	94
95	95	(% class="box infomessage" %)
96	96	(((
97		- @username:domain
	169	+ name, email address, username  @username:homeserver
98	98	)))
99	99
100		-The invitation will then appear in the Matrix client of the just-added user and must be accepted.
	172	+and send the invitation to the e-mail address of the person to be invited. [[image:invitepeople1.png||height="298" width="687"]]
101	101
102		-
	174	+
	175	+The invitation will appear in the element chat window and must be accepted.
	176	+
	177	+[[image:invitepeople2.png||height="263" width="686"]]
	178	+
	179	+
	180	+----