# Matrix-Synapse/Element

This book covers setting up a Matrix-Synapse/Element account with your Firehawk-Systems account

# First-time Login

<p class="callout info">It is strongly recommended to create a Firehawk-Systems account before accessing Matrix-Synapse/Element</p>

If you don't have a Firehawk-Systems account, follow this process [https://knowledge.firehawk-systems.com/books/managing-your-account/page/requesting-an-account](https://knowledge.firehawk-systems.com/books/managing-your-account/page/requesting-an-account)

### Account Creation

Navigate to [https://chat.firehawk-systems.com](https://chat.firehawk-systems.com) then click on "Sign in"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/KsmldVYNxQ9QQfmd-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/KsmldVYNxQ9QQfmd-image.png)

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/YMeQQnAsxuRqzidb-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/YMeQQnAsxuRqzidb-image.png)

<p class="callout info">Note the Homeserver URL [https://matrix.firehawk-systems.com](https://matrix.firehawk-systems.com) will be required when logging in to Element X or Element Classic</p>

After clicking Continue, you will be taken to Matrix Authentication Service at [https://mas.firehawk-systems.com](https://mas.firehawk-systems.com). Click on "Continue with Firehawk-Systems"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/3e5oef8WNA1c4Qma-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/3e5oef8WNA1c4Qma-image.png)

You will then be taken to Authentik login page, where you can login with your Firehawk-Systems account

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/uNJnBGVhb8kl1VM4-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/uNJnBGVhb8kl1VM4-image.png)

<p class="callout warning">If you cannot login, email support@firehawk-systems.com with the title "REQUEST - Matrix-Synapse Access: &lt;my username&gt;"</p>

The next page will confirm information and allow profile information to be set. Details from the Identity Provider are used by default.

<p class="callout info">Uncheck the "Use" box if you want to change the information</p>

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/t6kF2FxheXL45LpC-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/t6kF2FxheXL45LpC-image.png)

Click on "Terms and Conditions" then check the box. Do not create your account if you do not agree.

If prompted with the below page, press "Continue"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/8mah49m7WYjsiFxw-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/8mah49m7WYjsiFxw-image.png)

<p class="callout danger">Your account setup is NOT complete yet! Keep reading</p>

### Set up Secure Key Backup

You will see a popup to "Back up your chats" - this is essential for synchronizing messages to multiple devices. Click "Continue"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/tWArZ9dMhC40TGwB-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/tWArZ9dMhC40TGwB-image.png)

Click "Get recovery key", then click "Continue" on the next screen

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/ttZqJXf3TMxfK6in-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/ttZqJXf3TMxfK6in-image.png)

<p class="callout info">This key will be needed if you ever lose access to your last device logged into Element</p>

Click the copy button to the right of the "Recovery key" and save it somewhere safe

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/j5LOXyCRcWC4g2g5-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/j5LOXyCRcWC4g2g5-image.png)

The next page will prompt you for the recovery key that was just generated. When complete, the Backup section should show "Change recovery key"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/J2IH4R9hiC0qIxUF-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/J2IH4R9hiC0qIxUF-image.png)

### Connecting Element App

Navigate to [https://element.io/download](https://element.io/download) and select your system, then download and install the application

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/5Rjop1YBHc3vWSWL-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/5Rjop1YBHc3vWSWL-image.png)

#### Element X

<p class="callout info">This process is easier if you have the session in Element Web from the previous step still open</p>

Once you have downloaded Element X from the app store, open it.

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/ajeZZjzjlIlhsTvM-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/ajeZZjzjlIlhsTvM-image.png)

##### Login with QR Code

On Element Web, click on your profile, the "Link new device"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/mEXGk2bw6uWeb7dv-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/mEXGk2bw6uWeb7dv-image.png)

A QR code will then appear. On your mobile device, click "Sign in with QR code" then scan it

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/83L98rzVzw2tn2ls-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/83L98rzVzw2tn2ls-image.png)

The mobile device will produce a two-digit unique code that needs to be entered

[![Screenshot&#95;20260912&#95;194206.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/H1pFwb3NwcBFMXIN-screenshot-20260912-194206.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/H1pFwb3NwcBFMXIN-screenshot-20260912-194206.png)

Once done, the mobile device will produce a six-character unique code that needs to be entered

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/cJ6aV0lc18rmyPuP-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/cJ6aV0lc18rmyPuP-image.png)

Once done, a final confirmation will be shown. Tick the box and press "Grant access"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/I5B983nivrpCXx1m-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/I5B983nivrpCXx1m-image.png)

##### Sign in manually

If the QR method isn't possible or too difficult, select "Sign in manually".

You will be prompted for the homeserver, type in [https://matrix.firehawk-systems.com](https://matrix.firehawk-systems.com)

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/rrTWhggs2j5hbVLl-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/rrTWhggs2j5hbVLl-image.png)

When you press "Continue", you should be presented with a screen similar to when you signed in to Element Web. Press "Continue with Firehawk-Systems" and log in to your Firehawk-Systems account.

#### Complete Login

If prompted with a "Help improve Element X" page, click "Not now"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/UHpuTa0vJgIYHEvg-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/UHpuTa0vJgIYHEvg-image.png)

### You have completed the Element account setup/login

# Verifying Users

### Verify a User

Matrix-Synapse/Element provides the ability to establish trust of another user's keys. This mechanism will then warn you if that person's account gets compromised and sends you messages from a session they have not verified.

#### Check for Unverified Sessions

##### From yourself

To check your own sessions, login to Element Web, Element Desktop, or Element Web. Open Settings and go to "Sessions". Element will warn your if you have a unverified session

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/ThTixR13ZcCdUIz6-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/ThTixR13ZcCdUIz6-image.png)

You can action this warning by scrolling down to find the exact device.

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/MQBgGUjRBFMzaAup-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/MQBgGUjRBFMzaAup-image.png)

If you wish to remove the unverified device, you can click "Manage this session", then log in with your Firehawk-Systems account.

You can then click "Remove device"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/PFFtAHXjXsUKUKYR-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/PFFtAHXjXsUKUKYR-image.png)

##### From other users

It's important to be vigilant for unverified sessions among your contacts. Element will clearly warn you if a chat contains participants with unverified sessions by a red alert shield in the following places:

Next to the message input box

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/GfSLEPMNXXsLTl60-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/GfSLEPMNXXsLTl60-image.png)

In the chat detail screen

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/B3s670e4eMI9DKSl-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/B3s670e4eMI9DKSl-image.png)

In the chat's "People" list, next to the participants who has a unverified session

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/UJNANIdTjsaowOL7-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/UJNANIdTjsaowOL7-image.png)

And with each message from a unverified session.

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/GEoo1VcxUDECHn8s-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/GEoo1VcxUDECHn8s-image.png)

#### Establish Trust

All new users are in a neutral trust state initially. Select a chat of a user you wish to verify

##### Element Web/Desktop

Open settings by either pressing the info bubble

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/Xb4mvqRzQZiFoAxz-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/Xb4mvqRzQZiFoAxz-image.png)

Click on "People" then click on the user's name.

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/WlKJduomsFTrSUcf-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/WlKJduomsFTrSUcf-image.png)

A "Verify User" button will be visible under their profile picture

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/4m93vQRd585WTXZ1-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/4m93vQRd585WTXZ1-image.png)

##### Element X

Open the settings by clicking on the chat name

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/wqoBfLP7FjlxV1A0-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/wqoBfLP7FjlxV1A0-image.png)

Scroll down to "Profile"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/cCVmXMGrBooclAfr-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/cCVmXMGrBooclAfr-image.png)

Select "Verify user"

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/xSh3UKRJzoRtDaYV-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/xSh3UKRJzoRtDaYV-image.png)

#### Complete Verification

The other user will receive a verification request.

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/mPs4bmjPGhs2ax0A-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/mPs4bmjPGhs2ax0A-image.png)

They will then be presented with supported methods of verification.

Some devices support QR-code verification, which requires the device requesting verification to scan the QR code on the other, implying proximity. Another method is emoji verification, which exchanges a key in the background and requires matching the set of emojis on each device to ensure the integrity of the exchange remained.

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/5uza29SSIXOyfPIB-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/5uza29SSIXOyfPIB-image.png)

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/vFAC5feE326AIdsJ-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/vFAC5feE326AIdsJ-image.png)

When both parties press "They match", the verification process will conclude

[![image.png](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/scaled-1680-/076Ea2wmTWWbWf5j-image.png)](https://knowledge.firehawk-systems.com/uploads/images/gallery/2026-09/076Ea2wmTWWbWf5j-image.png)

### You have completed Verification of a Element user