Matrix

From pub.solar wiki
Revision as of 18:55, 7 January 2024 by Teutat3s (talk | contribs) (Updated instructions how to join bridged IRC rooms on Matrix)

Matrix is an open-standard, encrypted, and federated chat protocol. Clients exist for multiple platforms, including iOS, Android, Windows, Mac, and Linux. The standard client is called Element, and can be downloaded at https://element.io/download. A web interface hosted by us can be found at chat.pub.solar.

Basic information

More information on Matrix can be found on:

Setting up

Homeserver address for clients

When logging in to clients, you'll have to provide your homeserver address. This is matrix.pub.solar, not chat.pub.solar.

Saving your encryption keys

The first time you log in, you'll be asked to save your encryption keys. Make sure to write these down in a secure location! We recommend using a password manager. Matrix messages are end-to-end encrypted, which means that the administrators of pub.solar cannot read their contents. However, if you lose your encryption keys you'll lose access to all previous messages.

Bridging

Proprietary chat services such as Discord, Telegram, and WhatsApp can be bridged to Matrix, allowing you to communicate with users on the target network.

We offer Telegram and IRC bridges for our users. Otherwise, several public bridges are available, such as t2bot for Discord and Telegram.

Telegram

Instructions for setting up Telegram relay bridging for an existing Matrix room:

  1. Invite @telegrambot:pub.solar to the Matrix room.
  2. Invite @telegrambot:pub.solar to your Telegram group or channel and run /id to get its id.
  3. On Matrix, bridge the room by sending !tg bridge <room ID>.
  4. Finally, confirm with !tg continue

Note: If the Telegram room ID contains a negative sign (-), include it.

Puppeting is enabled on this instance.

IRC

As of January 2024, IRC bridging to Libera Chat (irc.libera.chat) and Scratch IRC (irc.scratch-network.net) is enabled.

Before reading on, try searching the public room list in your Matrix client if there is already an existing bridged room for the IRC channel you would like to join.

To join a channel on IRC from Matrix, simply join the room #_<SERVER>_<CHANNEL>, where <SERVER> and <CHANNEL> correspond to the IRC server and channel on that IRC server.

For example, to join the channel #pkgsrc on libera.chat IRC, join the Matrix room #_libera_#pkgsrc:pub.solar. One way of joining this room is by entering the following command in the chat box of any room in your Matrix client:

/join #_libera_#pkgsrc:pub.solar
Table of bridged IRC networks
Network Name Room alias format Appservice user
libera.chat #_libera_#channame:pub.solar @irc.libera.chat_NickServ:pub.solar
Scratch #_scratch_#channame:pub.solar @irc.scratch-network.net_NickServ:pub.solar

To check if the number of bridged IRC servers has changed in the mean time, inspect the Nix configuration and look for the entries below the line that says: in {.

Other apps

Official list of clients on matrix.org