MongooseIM is Erlang Solutions' robust, scalable and efficient XMPP server, aimed at large installations. Specifically designed for enterprise purposes, it is fault-tolerant, can utilise the resources of multiple clustered machines, and easily scale when more capacity is required by just adding nodes (new hardware boxes or VMs). It provides support for WebSockets and reimplemented BOSH (HTTP long-polling).


MongooseIM brings configurability, scalability and fault-tolerance to the core feature of XMPP – routing messages. Its architecture is based on a set of pluggable modules that enable different features, including:

  • Websockets: long-lived connections in the browser
  • BOSH: HTTP long-polling
  • MUC (Multi-User Chat): group chat
  • Rosters: contact list, and subscriptions to users' presences
  • MAM: Message Archive Management
  • Message Carbons: for multi-device, real-time copies of all messages
  • Last activity
  • Metrics
  • Offline messages
  • Privacy settings
  • vCards: user profiles

This modular architecture allows high customisability and easy access to the required features.

MongooseIM enables authenticating users using external or internal databases (Mnesia, RDBMS, NOSQL), LDAP or external scripts. It also allows connecting anonymous users, when required.

For storing persistent data, MongooseIM uses Mnesia (the distributed internal Erlang database) and also MySQL and PostgreSQL (RDBMS databases), and Riak KV (NOSQL). If necessary, MongooseIM can be customised to work with a database chosen by the customer.

Basic MongooseIM session storage is handled in Mnesia, but using Redis is also possible.

Deployment and management

MongooseIM can be deployed for a number of scenarios fitting customer needs. The default installation setup consists of a single MongooseIM node using Mnesia, so it does not require any additional services. This primary system is sufficient for fast deployment and connecting XMPP clients.

A more scalable solution would be deploying MongooseIM with an external database for persistent data. Such a setup requires a cluster of MongooseIM nodes, an external database, and a load balancer to manage the traffic from the client applications.

If deployed on a 16 GB RAM machine with at least 4 cores, a single MongooseIM node can handle 200-300 thousands of online users. This setup is suitable for systems with up to 10 nodes.

If the service requires a cluster of more than 10 nodes, we recommend using Redis instead of Mnesia for session storage. To avoid a single point of failure, a master-slave Redis setup is advisable.

MongooseIM allows connecting different clusters as parts of larger systems. This feature is used in geo-localised services handling massive traffic from all over the world.

MongooseIM gathers over 40 different XMPP-related metrics, allowing close monitoring of what happens inside the nodes. To manage the users, rosters, messages and general settings, we provide a command-line tool, mongooseimctl.

Erlang Solutions also provides WombatOAM, an erlang VM monitoring solution, that enbales ops and devs to better understand what going on in a MongooseIM cluster.

For load testing consider Tide, another Erlang Solutions' tool that enables devs and ops to validate their scalability, given the clients scenarios.

Client side

In order to build client applications, the MoongooseIM team recommends the following libraries:

iOS XMPPframework, Objective-C Jayme, Swift
Android Smack, Java Retrofit, Java
Web Stanza.io/Strophe.js, JavaScript

General knowledge of Erlang and XMPP allows complete control over the system and its components.