Options: Extension Modules
MongooseIM provides a wide range of pluggable and configurable modules,
that implement various features including XEPs.
mod_muc enables Multi-User Chat (group chat),
mod_mam gives us Message Archive Management,
mod_stream_management is for stanza acknowledgement and stream resumption.
This modular architecture provides great flexibility for everyday operations and feature development.
A module configuration generally looks like this:
1 2 3 4
IQ processing policies
Some of the modules feature an
It defines the method for handling incoming IQ stanzas.
The server may use one of the following strategies to handle incoming IQ stanzas:
- Syntax: string, one of
iqdisc.type = "one_queue"
"queues" case alone, the following key becomes mandatory:
- Syntax: positive integer
iqdisc.workers = 50
Their semantics works as follows:
no_queueregisters a new IQ handler, which will be called in the context of the process serving the connection on which the IQ arrives.
one_queuespawns a new process by which the incoming IQ stanzas will be handled.
queuesspawns N worker processes, as provided by the
iqdisc.workerskey. Every incoming stanza will be then handled by one of those processes.
parallelregisters the handler without spawning any process: a new process will be spawned in place, for each incoming stanza.
Implements XEP-0050: Ad-Hoc Commands for advertising and executing application-specific commands, such as those related to a configuration workflow, using XEP-0004: Data Forms in order to structure the information exchange. This is extremely useful for use cases such as remote administration, user engagement via polls, and ChatBots.
Implements a subset of XEP-0079: Advanced Message Processing functionality, that enables entities to request, and servers to perform advanced processing of XMPP message stanzas, including reliable data transport, time-sensitive delivery, and expiration of transient messages.
Implements XEP-0191: Blocking Command, a simplified interface to privacy lists.
Allows users to connect to MongooseIM using BOSH (Bidirectional-streams Over Synchronous HTTP), the HTTP long-polling technique described in XEP-0124: Bidirectional-streams Over Synchronous HTTP (BOSH) and XEP-0206: XMPP Over BOSH.
Implements XEP-0115: Entity Capabilities. It queries clients for their supported functionalities and caches them in Mnesia. This module tightly cooperates with mod_pubsub in order to deliver PEP events to user's subscribers.
Implements XEP-0280: Message Carbons in order to keep all IM clients for a user engaged in a real-time conversation by carbon-copying all inbound and outbound messages to all interested resources (Full JIDs).
A central gateway providing access to a subset of MongooseIM functions by channels other than XMPP. Commands defined there are currently accessible via REST API.
Enables the XEP-0352: Client State Indication functionality.
Implements XEP-0030: Service Discovery for discovering information (capabilities, protocols, features) about other XMPP entities.
A framework module to build other notification-based modules on.
Allows sending online/offline notifications, chat and groupchat messages as events to Amazon Simple Notification Service.
Allows sending presence changes (to available/unavailable), chat and groupchat messages as events to a RabbitMQ server.
Implements XEP-0357: Push Notifications to provide push notifications to clients that are temporary unavailable.
Forward events to an external HTTP service. This applies to situations such as sending messages or presences to mobile/SMS/email push service, big data, or an analytics service.
Implements XEP-0215: External Service Discovery for discovering information about services external to the XMPP network. The main use-case is to help discover STUN/TURN servers to allow for negotiating media exchanges.
Implements XEP-0363: HTTP File Upload for coordinating with an XMPP server to upload files via HTTP and receive URLs that can be shared in messages.
Implements custom inbox XEP
Enables sharing a single XMPP domain between distinct datacenters (experimental).
Enables Jingle to SIP and SIP to Jingle translator.
Serves as a storage for crypto keys for
Implements XEP-0012: Last Activity for communicating information about the last activity associated with an XMPP entity (most recent presence information from an offline contact).
Implements XEP-0313: Message Archive Management, that defines a protocol to query and control an archive of messages stored on a server.
Implements XEP-0045: Multi-User Chat, for a featureful multi-user text chat (group chat), whereby multiple XMPP users can exchange messages in the context of a chat room. It is tightly coupled with user presence in chat rooms.
mongoose_commands, accessible via the client REST API.
Implements a logging subsystem for mod_muc.
Implements XEP Multi-User Chat Light.
mongoose_commands, accessible via client REST API.
Provides an offline messages storage that is compliant with XEP-0160: Best Practices for Handling Offline Messages.
<service-unavailable/> error when the message recipient is offline.
Implements XEP-0199: XMPP Ping, enabling periodic XMPP pings sent to clients and responds to those sent from clients.
This module implements XEP-0016: Privacy Lists, for enabling or disabling communication with other entities on a network.
Implements XEP-0049: Private XML Storage to store and query private user data in XML format.
This extension implements XEP-0060: Publish-Subscribe. It is a pluggable implementation using behaviours provided by
Implements XEP-0077: In-Band Registration, that enables creating an account and changing the password once connected. This does not provide a solution to the forgotten password use case via SMS or email.
With this extension, MongooseIM may serve as a reverse proxy.
This module is deprecated and can only be configured with the older,
.cfg configuration file.
Please refer to the older versions of the documentation to see how to do this.
This module, when enabled, will inject roster entries fetched from LDAP.
Implements XEP-0279: Server IP Check that enables a client to discover its external IP address.
Enables XEP-0198: Stream Management functionality that defines the active management of an XML stream between two XMPP entities, including features for stanza acknowledgements and stream resumption.
XEP-0202: Entity Time implementation. With this extensions, clients can get the current server time.
This module provides the functionality specified in XEP-0092: Software Version.
Modules incompatible with dynamic domains
There are some modules that don't support dynamic domains for now.
These must not be enabled when using host types in