_index.en.md 8.54 KB
Newer Older
Marvin Dropp's avatar
Marvin Dropp committed
1
2
3
4
5
6
7
8
9
10
---
title: "First steps"
date: 2020-08-02T21:26:25+02:00
chapter: true
draft: false
weight: 2
---

# First steps - How to use Matrix?

Stefan Ruehl's avatar
Stefan Ruehl committed
11
Members and members of the Darmstadt University of Applied Sciences (of course also students) can use their **University Login** to communicate with members of the Darmstadt University of Applied Sciences and other universities and other Matrix users (e.g. academic partners) via chat and audio/video telephony in compliance with the relevant legal and regulatory provisions on data protection and IT security.
Marvin Dropp's avatar
Marvin Dropp committed
12
13
14
15
16
17
18
19
communicate.

{{% notice tip %}}
We recommend using the Element desktop client, because this avoids most problems users have with Matrix, e.g. end to end encryption.
{{% /notice %}}

Downloads for: {{% button href="https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe" icon="fas fa-download" %}}Windows{{% /button %}} {{% button href="https://packages.riot.im/desktop/install/macos/Element.dmg" icon="fas fa-download" %}}macOS{{% /button %}} {{% button href="/clients/install_linux" icon="fas fa-download" %}}Linux{{% /button %}}

Stefan Ruehl's avatar
Stefan Ruehl committed
20
After a desktop installation, make sure to use the existing account with the University Login and not to create a new account on another server. Here the example of Element:
Marvin Dropp's avatar
Marvin Dropp committed
21
22
23
24
25
26
27

![Selected login button in the element matrix client](/images/01_Login_en.png)

This is done by clicking on **Change**. Then you will not accidentally end up on the wrong server...

![Change login page with focus on the homeserver button](/images/02_Change-Homeserver_en.png)

Stefan Ruehl's avatar
Stefan Ruehl committed
28
Now you can manually specify the home server: https://matrix.fbi.h-da.de
Marvin Dropp's avatar
Marvin Dropp committed
29

Stefan Ruehl's avatar
Stefan Ruehl committed
30
![Input field to change the home server with the input matrix.fbi.h-da.de](/images/03_Set-Homeserver_en.png)
Marvin Dropp's avatar
Marvin Dropp committed
31

Stefan Ruehl's avatar
Stefan Ruehl committed
32
Afterwards the login with university login and university password must be carried out:
Marvin Dropp's avatar
Marvin Dropp committed
33
34
35

The drop-down menu "Log in with:" should be left at "User name". Then the following entries must be made:

Stefan Ruehl's avatar
Stefan Ruehl committed
36
**Username: University-Login** (only the University-Login, no e-mail address!)
Marvin Dropp's avatar
Marvin Dropp committed
37

Stefan Ruehl's avatar
Stefan Ruehl committed
38
**Password: University-Password**
Marvin Dropp's avatar
Marvin Dropp committed
39
40
41
42
43
44
45

An alternative login, e.g. using the e-mail address, is **NOT** possible during the first, initial login, only after the second login.

After the first login there is also no e-mail / confirmation mail.

Analogous to e-mail addresses, this results in matrix addresses with the following structure:

Stefan Ruehl's avatar
Stefan Ruehl committed
46
@University-Login:matrix.fbi.h-da.de
Marvin Dropp's avatar
Marvin Dropp committed
47

Stefan Ruehl's avatar
Stefan Ruehl committed
48
![Login window with request to enter University login and password](/images/04_Username_en.png)
Marvin Dropp's avatar
Marvin Dropp committed
49
50
51

## Convenient use of end-to-end encryption (E2EE)

Stefan Ruehl's avatar
Stefan Ruehl committed
52
Matrix not only encrypts transports to and from the home server (in the data center of Darmstadt University of Applied Sciences) but also allows the use of end-to-end encryption (E2EE). For this, cryptographic keys have to be exchanged between all devices that want to write end-to-end encrypted. This technical necessity sounds and is complicated, but in the meantime it has become very convenient for the users. The many cryptographic keys created by the client are stored on the respective device. If this is a tab in a browser, for example, there is a risk that this tab will be closed unintentionally. Then all encrypted contents are no longer readable. To prevent this from happening, a key protection is offered on the home server of the Darmstadt University of Applied Sciences, on which (protected with a security phrase (or security key that can be calculated from it) all cryptographic keys are stored encrypted. 
Stefan Ruehl's avatar
Stefan Ruehl committed
53
   
Marvin Dropp's avatar
Marvin Dropp committed
54
{{% notice info %}}
Stefan Ruehl's avatar
Stefan Ruehl committed
55
It is highly recommended to use this key backup (with a secure security phrase which is NOT your University password) and read on at [Other important settings]({{< relref "settings/_index.en.md" >}})!
Marvin Dropp's avatar
Marvin Dropp committed
56
57
{{% /notice %}}
   
58
![Screenshot of the prompt to enter a security phrase](/images/01_Restore-Session_withoutKey_en.png)
Marvin Dropp's avatar
Marvin Dropp committed
59

60
You have to skip this too, because you did not have any protection key yet:
Marvin Dropp's avatar
Marvin Dropp committed
61
62
63
   
![Confirmation of skipping the input of a security phrase](/images/03_Cancel-Restore_en.png)

64
65
Key protection is highly recommended for worry-free end-to-end encryption. Therefore you have to choose "Settings/Security & Privacy". Please look for "Encryption" and choose "setup secure backup".

66
![secure backup of securitykey step1](/images/03_Make_Key_Backup_1_en.png)
67
68

The next window will look like this:
69
![secure backup of securitykey step2](/images/03_Make_Key_Backup_2_en.png)
70
71
72
73

Please choose "Generate a Security Key" and "Continue".
In the next windows you will see your security key. This should be kept save and retrievable as an emergency key.

74
![Securitykey backup](/images/03_Make_Key_Backup_3_en.png)
Marvin Dropp's avatar
Marvin Dropp committed
75
76

   
77
78
With each login to elements you will see the following window:

79
![help to improve](/images/01_Help_to_improve_en.png)
80
81

This question you can answer as you like.
Marvin Dropp's avatar
Marvin Dropp committed
82
83
84
85
86

## Webclient

For using the Webclient, see the manuel under [clients -> browser]({{< relref "clients/browser.en.md" >}})

Stefan Ruehl's avatar
Stefan Ruehl committed
87
A registration of accounts (as known from other matrix servers) is not possible here at the Darmstadt University of Applied Sciences, because only persons with University login can use the service. The Darmstadt University of Applied Sciences is not a communication service provider. 
Marvin Dropp's avatar
Marvin Dropp committed
88

Stefan Ruehl's avatar
Stefan Ruehl committed
89
For scientific cooperations with colleagues without a University account there is the possibility to [apply for a university guest account](https://sd.h-da.de), which also entitles to use Matrix.
Marvin Dropp's avatar
Marvin Dropp committed
90
91
92

However, the federation with the Matrix servers of other scientific or civil society institutions will soon be possible (analogous to the existing e-mail federation). Example servers with which communication is already possible are:

93
94
95
96
* [TU Freiberg](https://matrix.tu-freiberg.de/) incl. [Docu](https://tu-freiberg.de/en/urz/dienste/chat)

* [TU Chemnitz](https://matrix.tu-chemnitz.de) incl. [Docu](https://www.tu-chemnitz.de/urz/groupware/chat/doku/)

97
98
* [Hochschule Darmstadt](https://chat.fbi.h-da.de) incl. [Doku](https://its.h-da.io/element-docs/)

99
100
* [Hochschule Zittau-Görlitz](https://matrix.hszg.de) incl. [Docu](https://zfe.hszg.de/das-zfe/aktuelle-entwicklungen/matrix)

Christian Bruchatz's avatar
Christian Bruchatz committed
101
102
* [HMT Leipzig](https://matrix.hmt-leipzig.de)

Christian Bruchatz's avatar
Christian Bruchatz committed
103
* [Uni Kiel](https://riot.fs-infmath.uni-kiel.de) incl. [Docu](https://www.fs-infmath.uni-kiel.de/wiki/Technische_Dienste)
Marvin Dropp's avatar
Marvin Dropp committed
104
105
106

* [Uni Hamburg](http://uni-hamburg.de/)

Christian Bruchatz's avatar
Christian Bruchatz committed
107
108
* [Uni Bremen](https://element.stugen.de/#/welcome)

109
110
* [TU Berlin](https://chat.tu-berlin.de/) incl. [Docu](https://www.innocampus.tu-berlin.de/projekte/matrixinnocampus/)

Christian Bruchatz's avatar
Christian Bruchatz committed
111
112
113
114
115
116
117
118
119
120
121
122
123
* [Humboldt Uni Berlin](https://element.hu-berlin.de/) incl. [Docu](https://www.digitale-lehre.hu-berlin.de/de/lehr-und-lernlandschaft/element)

* [TU München](https://matrix.tum.de) incl. [Docu](https://wiki.in.tum.de/Informatik/Helpdesk/RIOT)

* [Uni Hannover](https://matrix.uni-hannover.de) incl. [Docu](https://www.luis.uni-hannover.de/de/services/kommunikation/matrix-messenger/)

* [Uni Osnabrück](https://chat.virtuos.uni-osnabrueck.de/#/welcome) incl. [Docu](https://www.rz.uni-osnabrueck.de/homeoffice/riot.html)

* [Uni Bielefeld](https://uni-bielefeld.de/teamchat2)

* [Bauhaus-Universität Weimar](https://matrix.bau-ha.us) incl. [Docu](https://m18.uni-weimar.de/stuko/referate/digitale-infrastruktur)

* [RWTH Aachen](https://riot.comsys.rwth-aachen.de/)
124
125

* [Ruhr Universität Bochum](https://riot.rub.de/) incl. [Docu](https://www.it-services.ruhr-uni-bochum.de/services/issi/element.html.de)
126

127
* [Uni Bonn](https://element.matrix.informatik.uni-bonn.de/)
Marvin Dropp's avatar
Marvin Dropp committed
128

Christian Bruchatz's avatar
Christian Bruchatz committed
129
* [Uni Heidelberg](https://matrix-im.uni-heidelberg.de/) incl. [Docu](https://www.urz.uni-heidelberg.de/en/heichat)
Marvin Dropp's avatar
Marvin Dropp committed
130

Christian Bruchatz's avatar
Christian Bruchatz committed
131
* [Karlsruher Institut für Technologie (KIT)](https://dsn.tm.kit.edu)
Marvin Dropp's avatar
Marvin Dropp committed
132

Christian Bruchatz's avatar
Christian Bruchatz committed
133
134
135
* [Uni Augsburg](https://element.physik.uni-augsburg.de/#/welcome) incl. [Docu](https://www.uni-augsburg.de/de/fakultaet/mntf/physik/facilities/itservices/elequick/)

* [Uni Stuttgart](https://chat.stuvus.de/) incl. [Docu](https://wiki.stuvus.uni-stuttgart.de/display/ITKB/Matrix+Messenger)
Marvin Dropp's avatar
Marvin Dropp committed
136

Christian Bruchatz's avatar
Christian Bruchatz committed
137
138
139
140
141
142
143
144

Explizit für Studierende:

* [StudiChat](https://chat.studichat.de/#/welcome) (für alle)

* [Fachschaften](https://matrix.fachschaften.org/) (für Fachschaften)

Weitere europäische Hochschulen:
Marvin Dropp's avatar
Marvin Dropp committed
145

146
* [ETH Zürich](https://element.phys.ethz.ch/) incl. [Docu](https://readme.phys.ethz.ch/chat/)
147

Christian Bruchatz's avatar
Christian Bruchatz committed
148
149
* [Universität Innsbruck](https://chat.uibk.ac.at/) incl. [Docu](https://www.uibk.ac.at/zid/anleitungen/chat/)

Marvin Dropp's avatar
Marvin Dropp committed
150
151
* [University for Business and Technology, Kosovo](https://ubt-uni.net/)

Marvin Dropp's avatar
Marvin Dropp committed
152
153
A map displaying these listed servers is shown at ["Why Matrix?"]({{< ref "why"  >}} "Why Matrix?").

Marvin Dropp's avatar
Marvin Dropp committed
154
155
For civil use of the Matrix protocol, here is a list of public home servers that can also be used by Kolleg:innen if their institution does not yet offer a Matrix server:
[https://www.hello-matrix.net/public_servers.php](https://www.hello-matrix.net/public_servers.php)