Differences

This shows you the differences between two versions of the page.

--- general:matrix [2022-11-24 09:57] – [Our Instance] Kai Luca Spanheimer
+++ general:matrix [2024-09-10 14:35] (current) – added warning for security key and added group Kay-Robert Dormann
@@ Line 1: / Line 1: @@
 ====== Matrix ======
 Matrix is an open standard and communication protocol for real-time communication. It creates the possibility of decentralized communication with data-sovereignity.
 ====== Our Instance ======
 The IPKM has an own instance of the standard Matrix-Server 'Synapse' running at [[https://matrix.pkm.physik.tu-darmstadt.de]].
 You can access it either by the client running at [[https://element.pkm.physik.tu-darmstadt.de]] or by a client you locally install on any of your devices.
-A list of Matrix clients can be found [[https://matrix.org/clients/|here]].
+The standard client "Element" can be downloaded [[https://element.io/download|here]]. It is recommended to use this standard client but  you are free to use whichever you want.
-The client will ask you for credentials which are your IPKM account name and your password, as used for your [[general:mail|Mail account]].
+A list of alternative Matrix clients can be found [[https://matrix.org/clients/|here]].
+The client will ask you for credentials which are your IPKM account name and your password.
 If you use a client that is not the one hosted by the institute you will need to refer the client to our server while login in.
+While Matrix can be "federated", i.e. you can connect and post on other instances (for example the official matrix.org server), our server has federation switched off for now and is limited to our institute only.
 ===== Usage =====
-Since Slack has established itself as the de-facto-standard for workplace communication at our institute you will pleased to here that the 'Element' standard client for Matrix is designed with Slacks functionality as reference.
+The matrix server auto-populates the account into its own database from LDAP (=mail server account list) when that user signs in for the first time. There is no automatic discovery otherwise!
+**This means other users won't see people that are in LDAP (=mail server account) but have never signed in to matrix.**
+=== Login Flow ===
+To make the login process as easy as possible a login flow for an external client is presented here.
+{{:general:element_login_login_screen.png?200 |}}
+{{:general:element_login_choose_homeserver.png?200 |}}{{:general:element_login_sign_in.png?200 |}}{{:general:element_login_verify_request.png?200 |}}{{:general:element_login_cross_sign.png?200|}}
+  - The login starts by choosing the login method you are going to use. In our case one needs to choose "custom server". It should also be possible to just use your matrix ID but as of time of writing this does not work.
+  - In the following screen you have to enter the URL of our Matrix server:[[https://matrix.pkm.physik.tu-darmstadt.de]]
+  - After that choose login and enter your credentials. Namely your IPKM-username and the corresponding password
+  - If you already have another client session running you are asked to cross-sign your sessions by either scanning a QR-code with one of your clients or comparing a set of emojis shown in both clients.
+<WRAP center round important 60%>
+**Please make sure you have saved your matrix security key!!**
+</WRAP>
+=== Daily use ===
+Most clients organize the messages and group-chats in so called 'Spaces'. These work as groups with members and groupchats and can for example be used for coordinate your AG.
+=== Institute use ===
+There exist at least several Spaces that are used in our institute for work communication. The following list should be freely added to and modified if your AG starts their own space or some internal groups start a Space. If you enter a Space into the list also write down whom it is for and who manages it at the moment. If you want to get into a group, write an email to this responsible person with your matrix user name and the group affiliation.
+  - Soft Matter Gang. This Space is meant as a place to coordinate anything concerning all people in S20|4 ([[https://www.ipkm.tu-darmstadt.de/research_ipkm/team_ipkm/team_ipkm_details_68032.en.jsp|Kay-Robert Dormann]])
+  - SMT. This is a group intern space for the AG of Benno Liebchen ([[https://www.ipkm.tu-darmstadt.de/research_ipkm/team_ipkm/team_ipkm_details_68032.en.jsp|Kay-Robert Dormann]])
+  - PbwM. This is a group intern space for the AG of Emanuel Schneck ([[https://www.ipkm.tu-darmstadt.de/research_ipkm/team_ipkm/team_ipkm_details_68032.en.jsp|Kay-Robert Dormann]])
+  - SMI. This is a group intern space for the AG of Regine von Klitzing ([[https://www.ipkm.tu-darmstadt.de/research_ipkm/team_ipkm/team_ipkm_details_69504.en.jsp|Thomas Tilger]])
+Since Slack has established itself as the de-facto-standard for workplace communication at our institute you will pleased to here that the 'Element' standard client for Matrix is designed with Slacks functionality as reference. Thus Matrix-'Spaces' and Slack-'Workspaces' are virtually equivalent.
 Workspaces and channels work similarly on Matrix.
 So we should switch from Slack to Matrix due to the following
@@ Line 23: / Line 59: @@
 If you don't like the design of the standard matrix client you can just change it. Multiple clients display your messages in different ways and exist for most operating systems.
 So for any taste there will be a client.
+===== Threads like in Slack =====
+In order to get the same thread structure Slack has to offer, it is possible to opt in to the threads-beta that clients like Element offer. Just click "reply in thread" under any message, and agree to the opt-in. Since its a beta feature it might break at some point, in that case simply go to your settings ("top left" -> all settings -> labs) and opt out of the beta, then opt in again.