Module Description

This module implements XEP-0206: XMPP Over BOSH (using XEP-0124: Bidirectional-streams Over Synchronous HTTP (BOSH)), allowing clients to connect to MongooseIM over regular HTTP long-lived connections.

If you want to use BOSH, you must enable it both in the listen section of mongooseim.toml (Listener Modules) and as a module.



  • Syntax: positive integer or the string "infinity"
  • Default: 30
  • Example: inactivity = 30

Maximum allowed inactivity time for a BOSH connection. Please note that a long-polling request is not considered to be an inactivity.


  • Syntax: positive integer or the string "infinity"
  • Default: "infinity"
  • Example: max_wait = 30

This is the longest time (in seconds) that the connection manager will wait before responding to any request during the session.


  • Syntax: boolean
  • Default: false
  • Example: server_acks = true

Enables/disables acks sent by server.


  • Syntax: positive integer
  • Default: 120
  • Example: maxpause = 30

Maximum allowed pause in seconds (e.g. to switch between pages and then resume connection) to request by client-side.

Example Configuration

In the listener section:

  port = 5280
  transport.num_acceptors = 10
  transport.max_connections = 1024

    host = "_"
    path = "/http-bind"

In the module section:

  inactivity = 20
  max_wait = "infinity"
  server_acks = true
  maxpause = 120