Table of Contents


WebSockets is a protocol for providing web pages with simple two-way communication with a web server. This module allows browsers to communicate with Prosody via XMPP over WebSockets. This usually induces less overhead than using BOSH.

There are many JavaScript XMPP libraries capable of utilizing WebSockets, among them:


modules_enabled = {
    -- Other modules
    "websocket"; -- Enable mod_websocket

To allow requests that would normally break the Same-Origin policy, the cross_domain_websocket option can be used. Set it to true to enable cross-domain requests from all websites, or specify a list:

cross_domain_websocket = { "", "" };

If encryption is provided by a HTTP proxy, Prosody won't be able to see this, and consider the connection insecure (consequently forbidding some authentication mechanisms). In this case Prosody can be told to always consider WebSocket connections secure by setting

consider_websocket_secure = true;

The WebSocket endpoint will be at and by default, see HTTP path configuration if you would like to change this.

doc/modules/mod_websocket.txt · Last modified: 2015/02/21 12:14 by Florian Zeitz