• What it is
  • Glossary
• Where to start
• External User
  • User with a different Matrix home server
  • People without Matrix access
• Mobile Apps
• Desktop Apps
• Backup your encryption key

What it is

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.

Glossary

There many names involved we should clear out

• Matrix: The open communications protocol
• Element: The main developer of your software stack (Element.io)
• Element-web: The Matrix Web client
• Element X: The recommended mobile app
• Synapse: The Matrix server backend
• MAS: Matrix Authentication Server - Backend Managing the Matrix Users

Where to start

Starting is quite easy: Go to our Element-Web Client ITP Element-Web

ITP Users and other users select select "Sign In".

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.

Then you will be redirected to MAS, the Matrix Authentication Service. This service manages the access to Matrix.

You will be redirected to our SSO Login "Authentic". Enter your ITP creadentials

There you have to confirm your user and your have successfully login in. The Element Session will normally not expire.

External User

User with a different Matrix home server

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.

People without Matrix access

People with no other option can be invited to enroll to Authentik. Please ask Support for an invitation key. 

Mobile Apps

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.

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.

Desktop Apps

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.

Backup your encryption key

After you have sent your first chat message, encryption is activated and you will see the this pop up:

Click on continue.

The recovery section is marked with a red dot. Click on the button "Setup recovery".

Follow the guide and store the displayed key in a secure place (eg. password manager like k).