Setting Up the XMPP Bridge

Configuring the XMPP Bridge

The XMPP bridge relies on the xmpp "component" feature. It is an equivalent of matrix application services. You need to configure an XMPP Component on an XMPP Server that the bridge will use to bridge matrix and xmpp user.

On the hosting machine

From the Installer's Integrations page, click "Install" under "XMPP Bridge".

For the provided xmpp.yml, please use the following documentation to configure the bridge:

In all the examples below the follow are set

domain_name from parameters.yml : element.local XMPP Server FQDN: XMPP External Component/xmpp_domain:

Prosody Example

If you are configuring prosody, you need the following component configuration (for the sample xmpp server,

    Component ""
        ssl = {
          certificate = "/etc/prosody/certs/tls.crt";
          key = "/etc/prosody/certs/tls.key";
      component_secret = "eeb8choosaim3oothaeGh0aequiop4ji"

And then with that configured, you would pass the following into xmpp.yml:

xmpp_service: xmpp://
xmpp_domain: "" # external component subdomain
xmpp_component_password: eeb8choosaim3oothaeGh0aequiop4ji # xmpp component password

Note: We've used pwgen 32 1 to generate the component_secret.

Joining an XMPP Room

Once you have the XMPP bridge up, you need to map an XMPP room to a Matrix ID. To do this, if the room on XMPP is named:

(conference is the fqdn of the component's hosting rooms on our xmpp test instance)

then on Matrix, you would join:

The command to do that from within the Element client would be: (assuming your homeserver domain is


Joining a Matrix room from XMPP

If the Element/Matrix room is public you should be able to query the room list at the external component server address(Ex:

The Matrix room at alias #roomname:element.local maps to on the XMPP server if yout xmpp_domain:

Element XMPP
#roomname:element.local (native Matrix room) (bridged into XMPP) (bridged into Matrix/Element) (native XMPP room)

Revision #5
Created 28 November 2022 20:25:44 by Karl Abbott
Updated 28 February 2023 20:50:57 by Karl Abbott