# Using text-based chat with the Matrix protocol

Anyone can access public chatrooms hosted at domain example.org,
and get invited to join private chatrooms.

As user of Example orga,
you can create a personal [[account]] to access the chat service directly.
You can then create chatrooms,
and browse locally available chatrooms.


## Special strings

NB! This documentation uses special strings
which you may want to adapt for your local setup:

matrixhost: matrix.example.org
domain: example.org

organisation: Example orga


## Clients

Matrix chat is accessed with any of several [Matrix clients].

Recommended is to use the [Element] client,
either as web service,
Android app,
or iOS app.

You can use several clients at once.

[Matrix clients]: <https://matrix.org/docs/projects/try-matrix-now/>
  "Introduction to common Matrix clients"

[Element]: <https://element.io/get-started>
  "Element (formerly Riot and Vector) - free and open-source software instant messaging client implementing the Matrix protocol"


## Setup

Members can create an account locally at the domain example.org.
Guests may connect indirectly from another Matrix network.

To create a local member account,
tell your Matrix client to use the chatserver matrix.example.org
(some Matrix clients call it "Custom server" or "Home server").
Then request to create a new account,
providing your email address as proof of membership
(but do **not** provide a phone number).

Guests (and members too) can connect from outside -
i.e. using an account created at some other Matrix network.