====== FreeBSD Matrix Service ======

<callout type="warning">
**As of September 2023, %%FreeBSD%%'s Matrix service is considered experimental and in beta.**

Please note that there is no service level agreement (SLA) or data preservation guarantee. This server is only for experimental and feedback purposes.
</callout>

**Jump to**: [[#rooms|FreeBSD Project-provided spaces and rooms]]

About Matrix:

  * https://matrix.org/ – ❝An open network for secure, decentralised communication❞

About Element:

  * https://element.io/ – ❝a decentralized and flexible communications platform, built on the Matrix open standard…❞ – a server, an app, and more.

==== Contact ====

<matrix-admin@FreeBSD.org>

===== Server =====

The %%FreeBSD%% Project hosts a Matrix instance at ''%%matrix-dev.freebsd.org%%'' for project spaces and rooms.

**%%FreeBSD%% committers** can use it as their homeserver:
  * use your freefall username (without the ''%%@freebsd.org%%'' suffix) and [[https://docs.freebsd.org/en/articles/committers-guide/#kerberos-ldap|kerberos password]] to login and gain an ''%%id:matrix-dev.freebsd.org%%'' identity
  * when the beta ends, ''%%matrix-dev%%'' will be removed

**Other users** must choose an alternative homeserver. Servers with open registration:

  * https://servers.joinmatrix.org/

===== Clients =====

<callout type="info">
**To reduce the risk of losing a key and becoming unable to decrypt history: verify at least two client connections.**
</callout>

==== Element clients ====

Mobile, desktop, and Web: [[https://element.io/download|https://element.io/download]].

%%FreeBSD%% Project-hosted Element web: https://element-dev.freebsd.org/ – for ''%%matrix-dev.freebsd.org%%'' ID holders only.

Element X: https://element.io/labs/element-x – fastest, beta ([[https://github.com/vector-im/element-meta/issues/1915|status]]).

==== More clients ====

Either browse [[https://matrix.org/ecosystem/clients/|https://matrix.org/ecosystem/clients/]], or use the //Change// option that appears in ''%%matrix.to%%'' dialogues.

===== Public Spaces and Rooms =====

https://matrix.to/#/#public:matrix-dev.freebsd.org – the public //%%FreeBSD%%// space, which lists the rooms below, and more.

Active rooms:

| Lobby | [[https://matrix.to/#/#lobby:matrix-dev.freebsd.org|lobby]] | ''%%#lobby:matrix-dev.freebsd.org%%'' | Suggested starting point. Here, you might chat about anything (within reason). Using the lobby for off-topic chat will help to keep the //general// room attractive, for people who want to discuss %%FreeBSD%%. |
| General Discussion | [[https://matrix.to/#/#general:matrix-dev.freebsd.org|general]] | ''%%#general:matrix-dev.freebsd.org%%'' | General discussions related to %%FreeBSD%% |
| Developer Summit | [[https://matrix.to/#/#devsummit:matrix-dev.freebsd.org|devsummit]] | ''%%#devsummit:matrix-dev.freebsd.org%%'' | %%FreeBSD%% Developer Summits |

===== Hints =====

Screenshot: [[https://wiki.freebsd.org/Matrix?action=AttachFile&do=get&target=Using+an+Element+web+app+to+join+a+FreeBSD+Project-provided+room.png|using an Element web app to join a FreeBSD Project-provided room]]

  - click the search icon (circled, near top left)
  - type or paste the address of a room
  - accept the invitation to join.

Room names are not yet distinctive.

If ever you are disoriented: features such as the **ⓘ** (room info) button in Element web can reveal the %%FreeBSD%% context.

Screenshots:

  - this [[https://wiki.freebsd.org/Matrix?action=AttachFile&do=get&target=Element%2C+general.png|general room]] appears to be KDE-related
  - the info button shows that [[https://wiki.freebsd.org/Matrix?action=AttachFile&do=get&target=Element%2C+room+info.png|the room is on a ⋯.freebsd.org server]] (unrelated to KDE).