Gateways for XMPP and Matrix

Built-in gateways

The main IRC network on F-hub.org provides gateways (sometimes called portals) to allow connections from XMPP and Matrix accounts. For this we host our own instances of Biboumi (XMPP) and Appservice-IRC (Matrix). All IRC channels are automatically available via these gateways and should work almost like native XMPP or Matrix channels.

How to connect from XMPP

IRC Channels can be acessed like regular XMPP MUCs via #channel@irc.f-hub.org. Please be assured that despite the warning in your XMPP client, our IRC network does not expose your JID on public channels. For a permanent connection (IRC bouncer like) double check that the "persistence" channel setting is enabled or configure it via an ad-hoc command.

It is possible to authenitcate via this bridge with your IRC SASL account through ad-hoc commands, learn more about the gateway usage here.

If you are for example using the Cheogram mobile client you can authenticate yourself this way: First add the "irc.f-hub.org" gateway as a contact. If you open the chat there are two tabs at the top. Click on "Commands" and select "Configure a few settings for that IRC server" from the menu. Then you can specify your IRC username and SASL password and complete it by pressing Finish at the bottom.

You can create easy to share invite-links for XMPP here.

How to connect from Matrix

Room addresses syntax is something like #irc_#channel:matrix.f-hub.org. This makes it possible to connect with external Matrix accounts. It is possible to authenitcate via this bridge with your IRC SASL account, learn more about the portal usage here.

After setting up a user account on the IRC server, you can login to your registered irc account through the Matrix bridge. This is easiest to do if you haven't yet connected to the IRC server through the bridge bot. The commands for the Matrix bridge bot (@appservice-irc:matrix.f-hub.org) are:

!storepass (password) and !username (username) and then !reconnect

The simplest way to join an irc channel through the bridge service is to message the Matrix bridge bot: !join [irc.example.net] #channel [key] or you can use invite-links for Matrix created here.

Privacy notice

Please be aware that due to the federated nature of these services chat-logs and user names will become available to 3rd party services and may be retained indefinitly by them. No sensitive internal user-data from F-hub.org is shared however.


Revision #7
Created 29 April 2023 23:41:05 by Kris
Updated 18 March 2024 21:03:18 by Kris