Matrix: Difference between revisions

Revision as of 18:55, 7 January 2024

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:

Invite @telegrambot:pub.solar to the Matrix room.
Invite @telegrambot:pub.solar to your Telegram group or channel and run /id to get its id.
On Matrix, bridge the room by sending !tg bridge <room ID>.
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

@@ Line 36: / Line 36: @@
 ==== IRC ====
-Before joining, try to see if there is already an existing bridge to the channel.
+As of January 2024, IRC bridging to [https://libera.chat/ Libera Chat] (irc.libera.chat) and [https://interviewfor.red/en/starting.html Scratch IRC] (irc.scratch-network.net) is enabled.
-To join a channel on IRC from Matrix, simply invite <code><nowiki>#irc_<SERVER>_<CHANNEL></nowiki></code>, where <code><nowiki><SERVER></nowiki></code> and <code><nowiki><CHANNEL></nowiki></code> correspond to the server and channel.
+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.
-For instance, to join #pkgsrc on libera.chat, join [https://matrix.to/#/#irc_irc.libera.chat_#pkgsrc:pub.solar #irc_irc.libera.chat_#pkgsrc:pub.solar].
+To join a channel on IRC from Matrix, simply join the room <code>#_<SERVER>_<CHANNEL></code>, where <code><nowiki><SERVER></nowiki></code> and <code><nowiki><CHANNEL></nowiki></code> correspond to the IRC server and channel on that IRC server.
-As of January 2024, bridging to Libera Chat (irc.libera.chat) and Scratch IRC (irc.scratch-network.net) is enabled. To check if this has changed in the mean time, inspect [https://git.pub.solar/pub-solar/infra/src/branch/main/hosts/nachtigall/apps/matrix/irc.nix the Nix configuration] and look for the entries below the line that says: <code>in {</code>.
+For example, to join the channel #pkgsrc on libera.chat IRC, join the Matrix room [https://matrix.to/#/#_libera_#pkgsrc:pub.solar #_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
+{| class="wikitable"
+|+Table of bridged IRC networks
+!Network Name
+!Room alias format
+!Appservice user
+|-
+|libera.chat
+|<code>#_libera_#channame:pub.solar</code>
+|[https://matrix.to/#/@irc.libera.chat_NickServ:pub.solar @irc.libera.chat_NickServ:pub.solar]
+|-
+|Scratch
+|<code>#_scratch_#channame:pub.solar</code>
+|[https://matrix.to/#/@irc.scratch-network.net_NickServ: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 [https://git.pub.solar/pub-solar/infra/src/branch/main/hosts/nachtigall/apps/matrix/irc.nix the Nix configuration] and look for the entries below the line that says: <code>in {</code>.
 == Other apps ==
 [https://matrix.org/ecosystem/clients/ Official list of clients on matrix.org]