Skip to Content

Wiki source code of Element Messenger

Version 11.1 by Thomas Coelho (local) on 2026/02/27 10:34
Show last authors
1 {{warning}}
2 The Element Messenger is in testing. You can try it and report problems and ask questions. Currently voice and video calls are untested. The service can be taken down and your data (chats) can be deleted without notice.
3 {{/warning}}
4
5 {{toc/}}
6
7 = What it is =
8
9 Element is an implementation of the open Matrix protocol. Matrix is a messenger protocol with the same intend like What's app, also with features from Mattermost. As the main differences is, it is self hosted and federated (like email). This means, we run the server in our server room and you can communicate with people from other Matrix instances.
10
11 == Glossary ==
12
13 There many names involved we should clear out
14
15 * Matrix: The open communications protocol
16 * Element: The main developer of your software stack ([[Element.io>>https://element.io]])
17 * Element-web: The Matrix Web client
18 * Element X: The recommended mobile app
19 * Synapse: The Matrix server backend
20 * MAS: Matrix Authentication Server - Backend Managing the Matrix Users
21
22 = Where to start =
23
24 Starting is quite easy: Go to our Element-Web Client [[ITP Element-Web>>https://element.itp.uni-frankfurt.de]]
25
26 [[image:1771233799504-920.png]]
27
28 ITP Users and other users select select "Sign In".
29
30 Then you have to choose your "Home Server". The Element Web Client is independent from Matrix server. Click on continue, the ITP Matrix Service is preconfigured.
31
32 [[image:1771234068639-516.png]]
33
34 Then you will be redirected to MAS, the Matrix Authentication Service. This service manages the access to Matrix.
35
36
37 You will be redirected to our SSO Login "Authentic". Enter your ITP creadentials
38
39 There you have to confirm your user and your have successfully login in. The Element Session will normally not expire.
40
41 = External User =
42
43 == User with a different Matrix home server ==
44
45 Matrix is a federated service. You can communicate with any other Matrix user in the world. The HRZ offers an unsupported matrix instance. Communicating with university members is straight forward.
46
47 == People without Matrix access ==
48
49 People with no other option can be invited to enroll to Authentik. Please ask Support for an invitation key.
50
51 = Mobile Apps =
52
53 For sure Element is also available for iOS and Android. Please install "Element X" from your app store. Attention: There is also an "Element Classic" which is deprecated and does not work with MAS.
54
55 To setup the mobile app go to element web and click on the avatar icon in the left upper corner. Then choose "link new device". A QR code and instruction how to scan this with your mobile app.
56
57 = Desktop Apps =
58
59 On our managed ITP machines, the desktop application "Element" is installed. This is basically a wrapped version off the web client, which uses the Electron frame work.
60
61 = Backup your encryption key =
62
63 After you have sent your first chat message, encryption is activated and you will see the this pop up:
64
65
66