====== Getting started with Matrix on SDF ======

What is Matrix?
According to [[wp>Matrix_(protocol)|Wikipedia]], Matrix "is an open standard and communication protocol for real-time communication". Matrix should be feel familar for users of [[wp>Internet_Relay_Chat|IRC]], one of the first Internet communication protocols.

Like many modern social platforms, Matrix generally exists as multiple "federated" servers such that an account on one server allows access to many other servers. The SDF Matrix server – **matrix.sdf.org** – is a bit different: although rooms ((With the exception of **''[matrix]''** //Space rooms//‚ or //Spaces//.)) on remote servers are still accessible, for various reasons //login accounts are restricted to [[membership_levels#patron_lifetime_membership_level|SDF members]]//.

| The //[[matrix#notes|notes]]// section is mentioned to complement the //a bit different// ((SDF members may avoid this **''[matrix]''** server‚ if seeking [[wp>Parity|parity]] with the mentioned [[https://matrix.org/category/|categories]] or [[https://matrix.org/blog/|blog]]. [%%:!:%%] //external links//))\\ and //remote servers are still accessible// tutorial description. |

===== Getting an Account: =====

Unlike other SDF social platforms, Matrix accounts are by invitation only; to get an invite send an email to //membership@sdf.org// requesting a Matrix account along with the SDF //username// you plan to log in with.
Most requests are processed within 48 hours; an email containing your Matrix login and password will be sent to the email address associated with your SDF username.

===== Logging into Matrix: =====

There are several Matrix clients ((A matrix client //Connectivity to the server has been lost// message may occur when the SDF [[https://matrix.sdf.org|Matrix website′s]] certificate expires.)) for various platforms available; see [[https://matrix.org/ecosystem/clients/|https://matrix.org]] for specifics.  An easy way to get started is to point your web browser at [[https://app.element.io/#/login|https://element.io/#/login]], a browser-based Matrix client that is free to use.  The default "Homeserver" is //matrix.org//; you will need to click "edit" and change this to //matrix.sdf.org//, then enter your login credentials and click "Sign in".  Once you've successfully signed in you'll likely be prompted to create a secondary passphrase which will be used to create encryption keys for your account. Subsequent logins will then prompt for either the passphrase or the security key.

===== Say hello! =====

Once you've setup up your account – you can change your display name, avatar, themes, media options, etc. via the "Settings" menu – please join the //lobby// and say hi!  Posts in Matrix offer many formatting options as well as editting should the need arise.

===== Searching for Rooms/People =====

Matrix often shares "space" via "bridges" with other protocol such as IRC and Jabbr; for example one can use the "Search" feature to search for public channels on [[https://libera.chat/|libera.chat]], a popular IRC server used by various free software projects.  Most public room/channel names begin with a "#", an IRC convention.  Similarly, one can search for other users via the "People" tab.  Matrix users are indicated with a "@" prefix, ie. "@someone:matrix.sdf.org".  Clicking on someone in the "People" listing will initiate a private chat with that person.  If you aren't finding just the right room you can create one; click on the "+" under the "Home" icon to create a new "space".  Spaces can be public or private.

===== Server Status =====

[[https://matrix.sdf.org/|https://matrix.sdf.org]] displays some rudamentary ((A matrix client //Connectivity to the server has been lost// message may occur when the SDF [[https://matrix.sdf.org|Matrix website′s]] certificate expires.)) ((The service may need a restart <sup>(contact: ''[[:bboard|bboard]]'' → REQUESTS)</sup> to load a new certificate.)) Matrix stats: local and remote rooms, total number of rooms, users and instances.\\ [[https://matrix.sdf.org/_matrix/static/|Synapse is running]] displays the SDF Matrix Synapse server status, when //running//.

==== Reference ====

  - [[https://joinmatrix.org/guide/features/|More Features of Matrix]]
  - [[https://commonmark.org/help/|CommonMark]]
    - [[https://spec.commonmark.org/current/|CommonMark Spec]]

==== Donations ====

|  Donations for the SDF **''[matrix]''** server  |
| • Visit //membership levels// for **[[membership_levels#where_to_send_donations_membership_dues|more options]]**. |

=== Notes ===

^ //bboard// content: ^
| TRACKER membership (SDF Membership)\\ SUBJECT .. matrix.sdf.org down?\\ <REQUESTS.13-Feb-21> |
|//we were able to do some shuffling of data to create\\ more space. if you like //''matrix.sdf.org'' ((Invites are directed to [[:sdf|SDF]] members.))// please\\ consider ((Use [[bboard#browsing_messages|bboard]] uppercase //S// to search board //<ANNOUNCE>// for the word //matrix//.)) making a donation and we'll apply that to\\ a new larger server.//|