matrix-doc/docs/first-steps.md

89 lines
5.2 KiB
Markdown
Raw Normal View History

2021-07-31 14:14:01 -04:00
---
2021-08-05 13:29:50 -04:00
title: "First steps"
date: 2021-08-03T20:30:00+02:00
2021-07-31 14:14:01 -04:00
---
2021-08-05 13:29:50 -04:00
# First steps - How to use Matrix?
2021-07-31 14:14:01 -04:00
2021-08-05 13:29:50 -04:00
## Matrix-Login
2021-07-31 14:14:01 -04:00
2021-08-05 13:29:50 -04:00
!!! note
We recommend using the Element desktop client, because this avoids most problems users have with Matrix, e.g. end to end encryption.
2021-07-31 14:14:01 -04:00
2021-08-05 13:29:50 -04:00
Downloads for: [:fontawesome-solid-download: Windows](https://packages.riot.im/desktop/install/win32/x64/Element%20Setup.exe){ .md-button } [:fontawesome-solid-download: macOS](https://packages.riot.im/desktop/install/macos/Element.dmg){ .md-button } [:fontawesome-solid-download: Linux](/clients/install_linux){ .md-button }
2021-07-31 14:14:01 -04:00
2021-08-05 13:29:50 -04:00
After a desktop installation, make sure to use the existing account. Here the example of Element:
2021-07-31 14:14:01 -04:00
2021-08-06 04:48:18 -04:00
![Selected login button in the element matrix client](/images/01_Login_en.png "Selected login button in the element matrix client")
2021-07-31 14:14:01 -04:00
2021-08-05 13:29:50 -04:00
This is done by clicking on **Change**. Then you will not accidentally end up on the wrong server...
2021-07-31 14:14:01 -04:00
2021-08-06 04:48:18 -04:00
![Change login page with focus on the homeserver button](/images/02_Change-Homeserver_en.png "Change login page with focus on the homeserver button")
2021-07-31 14:14:01 -04:00
2022-09-20 12:43:17 -04:00
Now you can manually specify the homeserver: `matrix.envs.net`
2021-07-31 14:14:01 -04:00
2022-09-20 12:43:17 -04:00
![Input field to change the homeserver with the input matrix.envs.net](/images/03_Set-Homeserver_en.png "Input field to change the homeserver with the input matrix.envs.net")
2021-07-31 14:14:01 -04:00
2021-08-05 13:29:50 -04:00
Afterwards the login with username and password must be carried out:
The drop-down menu "Log in with:" should be left at "Username". Then the following entries must be made:
**Username**
Enter here your username from envs.net starting with a `@` sign followed by your username and the text `:envs.net`. For the user `isabell` it should like `@isabell:envs.net`.
2021-08-05 13:29:50 -04:00
**Password**
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:
`@username:envs.net`
2021-08-06 04:48:18 -04:00
![Login window with request to enter Username and Password](/images/04_Username_en.png "Login window with request to enter Username and Password")
2021-08-05 13:29:50 -04:00
## Convenient use of end-to-end encryption (E2EE)
2022-09-20 12:43:17 -04:00
Matrix not only encrypts transports to and from the homeserver of envs.net 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 homeserver of the envs.net, on which (protected with a security phrase (or security key that can be calculated from it) all cryptographic keys are stored encrypted.
2021-08-05 13:29:50 -04:00
!!! danger
It is highly recommended to use this key backup (with a secure security phrase which is **NOT** your login password)!
2021-08-06 04:48:18 -04:00
![Prompt to generate the security key or enter a security phrase](/images/11_Setup-Key_en.png "Prompt to generate the security key or enter a security phrase")
![Prompt to enter a password for the key backup](/images/12_Enter-Key_en.png "Prompt to enter a password for the key backup")
Alternatively, instead of the security phrase, you can also have a security key generated that serves the same purpose as the security phrase. Furthermore, the security key is generated in addition to the security phrase and should be kept safe and retrievable as an emergency key (e.g. save it as .txt file AND print it out)
![Display of the security key to write or save away](/images/13_Present-Key_en.png "Display of the security key to write or save away")
2021-08-05 13:29:50 -04:00
[Other important settings](/settings/) may improve your Matrix experience!
## Requests to setup the key backup
2021-08-06 04:48:18 -04:00
![Screenshot of the prompt to enter a security phrase](/images/01_Restore-Session_en.png "Screenshot of the prompt to enter a security phrase")
2021-08-05 13:29:50 -04:00
If you skipped the request to setup the key backup, the next screen would look like this:
2021-08-06 04:48:18 -04:00
![Confirmation of skipping the input of a security phrase](/images/03_Cancel-Restore_en.png "Confirmation of skipping the input of a security phrase")
2021-08-05 13:29:50 -04:00
Key protection is highly recommended for worry-free end-to-end encryption. For this reason, a smaller tooltip will prompt you to set up the encryption even after you skip further:
2021-08-06 04:48:18 -04:00
![Chat view showing a tooltip to set up encryption. Marking the confirm field](/images/04_Notification_en.png "Chat view showing a tooltip to set up encryption. Marking the confirm field")
2021-08-05 13:29:50 -04:00
If you omit this here as well, you will get a last warning if you log off consciously. If no key backup is set up at the latest, encrypted calls that may have already taken place cannot be accessed later. If the tab is closed, this also corresponds to a logout.
2021-08-06 04:48:18 -04:00
![Query if messages should be encrypted](/images/05_Logout-Notify_en.png "Query if messages should be encrypted")
2021-08-05 13:29:50 -04:00
Avoid this situation by setting up a key backup!
## Privacy policy
Privacy policy: [Link](https://envs.net/privacy-policy/)
## Impressum
Impressum: [Link](impressum.md)