This module forwards spam/abuse reports (e.g. those submitted by users via XEP-0377 via mod_spam_reporting) to one or more JIDs.


Install and enable the module the same as any other:

modules_enabled = {

There are two main options. You can set report_forward_to which accepts a list of JIDs to send all reports to (default is empty):

report_forward_to = { "" }

You can also control whether the module sends a report to the server from which the spam/abuse originated (default is true):

report_forward_to_origin = false

The module looks up an abuse report address using XEP-0157 (only XMPP addresses are accepted). If it fails to find any suitable destination, it will log a warning and not send the report.


This section is intended for developers.

XEP-0377 assumes the report is embedded within another protocol such as XEP-0191, and doesn’t specify a format for communicating “standalone” reports. This module transmits them inside a <message> stanza, and adds a <jid/> element (borrowed from XEP-0268):

<message from="prosody.example" to="destination.example">
    <report xmlns="urn:xmpp:reporting:1" reason="urn:xmpp:reporting:spam">
        <jid xmlns="urn:xmpp:jid:0">spammer@bad.example</jid>
          Never came trouble to my house like this.

It may also include the reported message, if this has been indicated by the user, wrapped in a XEP-0297 <forwarded/> element:

<message from="prosody.example" to="destination.example">
  <report reason="urn:xmpp:reporting:spam" xmlns="urn:xmpp:reporting:1">
    <jid xmlns="urn:xmpp:jid:0">spammer@bad.example</jid>
    <text>Never came trouble to my house like this.</text>
  <forwarded xmlns="urn:xmpp:forward:0">
    <message from="spammer@bad.example" to="victim@prosody.example" type="chat" xmlns="jabber:client">
      <body>Spam, Spam, Spam, Spam, Spam, Spam, baked beans, Spam, Spam and Spam!</body>


With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server= mod_report_forward

For earlier versions see the documentation for installing 3rd party modules