services:matrix:start
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
services:matrix:start [2020/11/19 10:40] – mention that stickers are still not supported behrmj87 | services:matrix:start [2022/10/13 14:21] (current) – update note at the top behrmj87 | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Matrix ====== | ====== Matrix ====== | ||
+ | <note tip>This is just the start page of the Matrix documentation, | ||
+ | If you have questions about Encryption have a look at | ||
+ | * [[services: | ||
+ | * [[services: | ||
+ | </ | ||
We are running a [[https:// | We are running a [[https:// | ||
Matrix is an instant messaging protocal, and is accessed by using a client. Analogously to how email is a protocol, and Gmail is a client. Like with email, there are many clients for Matrix. Different people can use different clients to contact each other. A good client to start using Matrix with is Element. You can use the web version of Element at [[https:// | Matrix is an instant messaging protocal, and is accessed by using a client. Analogously to how email is a protocol, and Gmail is a client. Like with email, there are many clients for Matrix. Different people can use different clients to contact each other. A good client to start using Matrix with is Element. You can use the web version of Element at [[https:// | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | Upon logging in with your usual ZEDAT credentials for the first time you will be added to rooms according to your group membership. | ||
Our Matrix server is not federated with the rest of the Matrix ecosystem, due to unresolved privacy questions, but we are giving access to external collaborators upon request. | Our Matrix server is not federated with the rest of the Matrix ecosystem, due to unresolved privacy questions, but we are giving access to external collaborators upon request. | ||
- | |||
- | Here is a guide for how to use Element. | ||
===== First Steps ===== | ===== First Steps ===== | ||
Line 93: | Line 88: | ||
==== Beyond Text ==== | ==== Beyond Text ==== | ||
- | In the Matrix client we provide, you can do more than write simple text (and uploading files and images). You can style your text with [[https:// | + | In the Matrix client we provide, you can do more than write simple text (and uploading files and images). You can style your text with [[https:// |
- | + | ||
- | We hope that TeX for math will be supported soon as well. | + | |
When you hover over one of your messages you get a little context menu, that we will explain now. The buttons are (from left to right) //quick reactions//, | When you hover over one of your messages you get a little context menu, that we will explain now. The buttons are (from left to right) //quick reactions//, | ||
Line 147: | Line 140: | ||
If you change your name or profile picture, other users will see it right away, but the menu will only show it once you log out and back in. | If you change your name or profile picture, other users will see it right away, but the menu will only show it once you log out and back in. | ||
+ | |||
+ | You can also change your name and avatar on a per-room basis. This works only with commands. To change your name, type ''/ | ||
==== Leaving a room ==== | ==== Leaving a room ==== | ||
Line 161: | Line 156: | ||
Press "Share room", and you will be presented with multiple means of sharing the room with someone | Press "Share room", and you will be presented with multiple means of sharing the room with someone | ||
{{ : | {{ : | ||
- | ==== Communities | + | ==== Spaces |
- | You might wonder, "I have a group of people, but we also have a set of topics and a single room for that might be confusing!" | + | <note tip>This feature used to be called communities before, but has been supplanted by //spaces// as of late May 2021.</ |
- | You can start a new community via the community sidebar <color # | + | You might wonder, "I have a group of people, but we also have a set of topics and a single room for that might be confusing!" |
- | {{ : | + | |
- | After starting a community, you can add people and rooms via sidebars, just like adding users to a room. | + | Unfortunately which spaces exist on the server is currently **not** searchable, so you will need to be invited |
- | When you join a community it gets added to your community | + | Spaces are handled via the sidebar |
- | ===== End-to-End-encryption ===== | + | {{ : |
- | <note important> | + | This shows the sidebar of an account with two spaces (with initials T and F). Clicking on either of them will narrow the list of direct conversations and rooms to only those that belong to that space. The button at the top will return you to the view where you see all your direct |
- | End-to-end encryption means that only the parties participating in a conversation | + | By default rooms that are part of a space are not shown in the list of rooms on the Home screen. If you want a room, that is part of a space, shown there you will need to either |
+ | - set it as a favourite via the three button menu when you hover over its name, | ||
+ | - right-click on the Home button and then on //Show all rooms//, or | ||
+ | - enable //Show all rooms in Home// in the Spaces section of the // | ||
+ | You can also just search for the name of the room in the search box above the list of all your rooms and conversations. | ||
- | <note warning> | + | === Public Spaces === |
- | <note warning>When logging into a new device (a different browser, a new phone, your fridge), | + | When you click to create |
- | ==== Upgrading encryption ==== | + | |
- | This step is necessary if you have used encryption in the past on your matrix.physik.fu-berlin.de account. If you have not used encryption previously, you can jump to the section [[services: | + | {{ :services: |
- | If you have used encryption before you will notice a small popup on the left side of the screen, asking you to upgrade. Click on the " | + | You can create public spaces (that - in the future - will be searchable like public rooms) and private spaces. Private spaces are for closed groups or just for your personal usage to organise rooms just the way you like. |
- | This concludes the upgrade. You can now on read how to verify users in // | + | If you click to create |
- | ==== Setting up encryption for the first time ==== | + | {{ : |
- | When you log in to Element, it will ask you to set up encryption recovery. This step will make sure that you can share encrypted messages across all your devices and different sessions. If you do not wish to use encryption you can skip this step. However as encryption will be used by default we highly recommend setting up encryption. | + | where you can set a name and description for the space. This dialog is the same when creating a private space. |
- | To setup encryption recovery | + | Afterwards |
- | {{ : | + | {{ : |
- | **Optional** By default the server backs up your encryption keys, so you can recover your encrypted messages if you loose access | + | If you already have rooms that you want to add to the space and don't want to create new ones, you must delete |
- | Additionally | + | Afterwards |
- | {{ : | + | {{ : |
- | ==== Verification ==== | + | You can always add rooms and people to your space later. |
- | **This step is optional** **If you choose to not verify a user there will be a black shield displayed next to their user icon** {{ : | + | Finally |
- | For end-to-end encryption to be really secure users have to verify they are talking to each other. To do this each user is verifying each their devices, and additionally verifies every user once. Every device another verified user verified themselves will be considered verified. | + | {{ : |
- | A user you did not verify will be displayed with a black shield next to their user icon: {{ : | + | Here you can add more rooms and people |
- | A user you verified, but who did not verify all of their devices will be displayed with a red shield next to their user icon: {{ : | + | === Private Spaces === |
- | A user you verified and who verified all of their devices | + | You can create private spaces for your groups or projects or just for yourself. That's the first question |
- | Example: Alice and Bob start a conversation in their logged in sessions. For the encryption to be secure they have to verify they are actually talking to each other. In Element this is done by comparing a list of emojis that are shown to both users. Alice requests a verification with Bob and they verify they get shown the same string of emojis. When Bob starts using a new session (e.g. using a different Browser/ | + | {{ :services: |
- | ==== Verify | + | If you press **Just me** here, you will be shown a list of all the rooms you are a member of and you can mark them to be added to your private space. |
- | For this step to make sense you have to be able to communicate with the other user in a way that makes sure you are actually talking to ****them****. For this we recommend video/ | + | if you press **Me and my teammates** you will be shown a dialog |
- | To verify a user you open a chat you share with the user and click their name in the user side bar. | + | {{ : |
- | {{ : | + | You //must// invite them via their usernames or skip this step for now, since for our Matrix instance users will not be able to join via app.element.io |
- | Click on the verify link in the sidebar… | + | Afterwards |
- | + | ||
- | {{ : | + | |
- | + | ||
- | and click on the "Start Verification" | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | The user you want to verify | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | You will then be presented with the verification options. Currently the only option is comparing a string of emojis. When both users have agreed on a verification method the verification process begins. | + | |
- | + | ||
- | If the user you are verifying with is shown the same string of emojis | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | ==== Verify a session ==== | + | |
- | + | ||
- | To access your encryption history and for other users to verify you it is necessary to verify a new session. To verify a session you can either confirm a new session from an existing session or enter your recovery passphrase. | + | |
- | + | ||
- | When logging in with a new device you will get prompted to verify it. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | If you are logged into another session there will be a popup asking you to verify the new session: | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Click on the green " | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Select to continue and you will be asked for a verification method. Currently the only option is to compare a sting of emojis. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Compare the emojis in the two sessions. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Confirm the emojis match on both devices to complete verifying the session. | + | |
- | + | ||
- | Alternatively you can select to verify a session by using your recovery passphrase: | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | ==== Deleting a session ==== | + | |
- | + | ||
- | If you have old unverified sessions that you don' | + | |
- | + | ||
- | To find out if you have unverified sessions left, enter a chat in which you participate and find your name in the user sidebar on the left. If you have unverified sessions, there will be a red shield icon on your user icon. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | If you have unverified sessions, click on your name in the sidebar. This will show you a list of your sessions and which of them are unverified. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Click on each of the unverified sessions which you can not access anymore and note down their session-ID. (In the picture below it is // | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | To delete the session you noted down, click on your Name in the top left corner and select the settings. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | In the settings menu select the section " | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | In the " | + | |
- | + | ||
- | {{ : | + | |
+ | If you later decide you want to share your private space with other people, you can always do that and invite people to it. Since the menu to add rooms to spaces is much nicer for personal use private rooms, this is the recommended way to create private spaces and to later invite more users to it instead of going through the general private space creation. | ||
===== Usage tips ===== | ===== Usage tips ===== | ||
Line 314: | Line 236: | ||
* You can reply to messages, quoting them thereby. Use the context menu when hovering over a message. | * You can reply to messages, quoting them thereby. Use the context menu when hovering over a message. | ||
* You can react to messages. Use the smilie context menu when hovering over a message. | * You can react to messages. Use the smilie context menu when hovering over a message. | ||
- | * You can add a [[services: | + | * You can add a [[services: |
+ | * If you need to see the actual events your client and the Matrix server are exchanging, you can see them by clicking '' | ||
+ | ===== More Documentation ===== | ||
+ | * [[services: |
services/matrix/start.txt · Last modified: 2022/10/13 14:21 by behrmj87