Matrix-Mirrors/matrix-doc
1
0
Fork 0
mirror of https://git.envs.net/envs/matrix-doc.git synced 2024-10-01 11:55:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

update first-steps.md

Browse Source
This commit is contained in:
creme 2021-08-05 19:29:50 +02:00
parent efc46f13c7
commit 247619c0fe
No known key found for this signature in database
GPG Key ID: C147C3B7FBDF08D0
1 changed files with 71 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

111
docs/first-steps.md
View File

@ -1,53 +1,84 @@
---
date: 2021-07-31T19:30:00+02:00
weight: 0
authors:
- cblte
- creme
title: "First steps"
date: 2021-08-03T20:30:00+02:00
---
# Matrix at envs.net
Matrix is a free and open, secure, decentralized protocol for real-time communication, also known by the name of one of its clients, Element.
# First steps - How to use Matrix?
<object data="images/matrix_interactive_en.svg" type="image/svg+xml" style="width: 1280px; max-width: 100%"></object>
## Matrix-Login
In recent years, the need for supporting digital tools for team collaboration has increased. A central tool is a team chat. According to Wikipedia, a chat refers to "electronic communication by means of written text in real time, usually via the Internet". ([Source](https://en.wikipedia.org/wiki/Chat)). With a messenger team members can make each other aware of current information and especially share links (*hyperlinks* / *links*) for further collaboration (e.g. for finding appointments, collaborative writing, planning events, editing data, code, mind maps,).
!!! note
We recommend using the Element desktop client, because this avoids most problems users have with Matrix, e.g. end to end encryption.
## Topics
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 }
* [Why Matrix and no other chat system?](why/why.md)
* [How can Matrix be used? (registration and first steps)](first-steps.md)
* [Recommendations for further important settings after first login](settings/_index.en.md)
* [Installation of a client / program](clients/_index.en.md)
* [Browsersettings](clients/browser.en.md)
* [Find people and send direct messages](messaging/_index.en.md)
* [Use end-to-end encryption](encryption/_index.en.md)
* [Create rooms and take responsibility](rooms/_index.en.md)
* [Sharing rooms and making them public](rooms/sharing.en.md)
* [Find rooms](rooms/find/_index.en.md)
* [Delete and leave rooms](rooms/delete/_index.en.md)
* [Fine-tune notifications](notifications/_index.en.md)
* [Use integrations, bridges, bots (e.g. Jitsi)](integrations/_index.en.md)
* [More Clients](clients/more_clients.en.md)
* [Using communities as room filters](communities/_index.en.md)
* [Further development of Matrix](development/_index.en.md)
* [Privacy policy](privacy/_index.en.md)
* [Imprint](imprint/_index.en.md)
* [Declaration of Accessibility](accessibility/_index.en.md)
After a desktop installation, make sure to use the existing account. Here the example of Element:
### Questions and Contact
![Selected login button in the element matrix client](/images/01_Login_en.png)
The ideal is to deal with problems in a transparent way, from which all others can learn. This can be done by describing the situation in the ENVS main room - here problems and solutions can be discussed together:
This is done by clicking on **Change**. Then you will not accidentally end up on the wrong server...
[#envs:envs.net](https://matrix.to/#/#envs:envs.net)
![Change login page with focus on the homeserver button](/images/02_Change-Homeserver_en.png)
<span class="note">
For some anomalies you can try to empty the cache and reload everything:
</span>
Now you can manually specify the home server: `matrix.envs.net`
`Settings > Help & About > Clear Cache and reload`
![Input field to change the home server with the input matrix.envs.net](/images/03_Set-Homeserver_en.png)
<span class="note">
Current maintenance is announced in the matrix room [#home:envs.net](https://matrix.to/#/#home:envs.net) and
[#status:envs.net](https://matrix.to/#/#status:envs.net).
</span>
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**
**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`
![Login window with request to enter Username and Password](/images/04_Username_en.png)
## Convenient use of end-to-end encryption (E2EE)
Matrix not only encrypts transports to and from the home server 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 home server 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.
!!! danger
It is highly recommended to use this key backup (with a secure security phrase which is **NOT** your login password)!
![Prompt to generate the security key or enter a security phrase](/images/11_Setup-Key_en.png)
![Prompt to enter a password for the key backup](/images/12_Enter-Key_en.png)
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)
[Other important settings](/settings/) may improve your Matrix experience!
## Requests to setup the key backup
![Screenshot of the prompt to enter a security phrase](/images/01_Restore-Session_en.png)
If you skipped the request to setup the key backup, the next screen would look like this:
![Confirmation of skipping the input of a security phrase](/images/03_Cancel-Restore_en.png)
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:
![Chat view showing a tooltip to set up encryption. Marking the confirm field](/images/04_Notification_en.png)
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.
![Query if messages should be encrypted](/images/05_Logout-Notify_en.png)
Avoid this situation by setting up a key backup!
## Privacy policy
Privacy policy: [Link](https://envs.net/privacy-policy/)
## Impressum
Impressum: [Link](impressum.md)