Unable to install mod_conversejs after following installation steps

[lucasl84]

Hi everyone,

I'm trying to make mod_conversejs work in the Docker ecs image but I'm not fully understanding the steps involved. I've read the following official docs: mod_conversejs and followed the described steps.

The mod_conversejs config that I'm using is the following:

  ...
  -
    port: PORT_HTTP_TLS
    ip: "::"
    module: ejabberd_http
    tls: true
    request_handlers:
      /admin: ejabberd_web_admin
      /api: mod_http_api
      /bosh: mod_bosh
      /captcha: ejabberd_captcha
      /upload: mod_http_upload
      /ws: ejabberd_http_ws
      /conversejs: mod_conversejs
  -
    port: PORT_HTTP
    ip: "::"
    module: ejabberd_http
    request_handlers:
      /admin: ejabberd_web_admin
      /.well-known/acme-challenge: ejabberd_acme
      /conversejs: mod_conversejs
...
modules:
  mod_conversejs:
    conversejs_resources: "/opt/ejabberd/conversejs/package/dist"
    conversejs_plugins: ["libsignal-protocol.min.js"]
  ...

I'm manually setting up the /opt/ejabberd/conversejs directory with the following Dockerfile steps using the conversejs-12.0.0.tgz release file:

RUN mkdir -p /opt/ejabberd/conversejs
COPY ./docker/.ejabberd/converse.js-12.0.0.tgz /tmp
RUN tar -xvzf /tmp/converse.js-12.0.0.tgz --directory /opt/ejabberd/conversejs
RUN chown -R ejabberd:ejabberd /opt/ejabberd/conversejs

I do believe that the above config/steps should be correct. But then mod_conversejs seems not to be installed nor available from the ecs docker image even after running ejabberdctl modules_update_specs. This is the list of available modules that I get:

ejabberd_auth_http	Authentication via HTTP request
ejabberd_observer_cli	Observer CLI plugins for ejabberd
mod_captcha_rust	Generate CAPTCHAs using Rust library
mod_cron	Execute scheduled commands
mod_default_contacts	Auto-add roster contacts on registration
mod_default_rooms	Auto-bookmark rooms on registration
mod_deny_omemo	Prevent OMEMO sessions from being established
mod_ecaptcha	Generate CAPTCHAs using ecaptcha
mod_example	Example ejabberd module for testing and development
mod_filter	Flexible filtering by server policy
mod_grafite	Publishes Statistics via statsd/grafite
mod_http_redirect	Redirect HTTP path to another URI
mod_isolation	Prevent routing of packets between virtual hosts
mod_libcluster	Join nodes into cluster
mod_log_chat	Logging chat messages in text files
mod_logsession	Log session connections to file
mod_logxml	Log XMPP packets to XML file
mod_message_log	Log one line per message transmission in text file
mod_muc_log_http	Serve MUC logs on the web
mod_muc_webchat_url	Show webchat_url in MUC rooms disco#info
mod_post_log	Logs messages to an HTTP API
mod_pottymouth	Filter bad words in messages
mod_prometheus	Prometheus metrics
mod_pubsub_serverinfo	Exposes server information over Pub/Sub
mod_push_offline	Send offline messages to a component
mod_rest	HTTP interface to POST stanzas into ejabberd
mod_s2s_log	Log all s2s connections in a file
mod_s3_upload	Upload files to S3-compatible storage
mod_shcommands	Execute shell commands
mod_spam_filter	Filter spam messages based on sender JID and content
mod_statsdx	Calculates and gathers statistics actively
mod_tombstones	Keep graveyard of accounts and rooms tombstones
mod_unified_push	Conversations-compatible UnifiedPush push server implementation
mod_webadmin_config	Show configuration in Web Admin
mod_webpresence	Publish user presence information in the web

As mod_conversejs is not available from the list when running ejabberdctl module_install mod_conversejs fails with: Error: not_available.

When navigating to http://localhost:5280/conversejs I do indeed see in the console the following error message:

mar1.ejabberd  | 2025-09-02 10:17:50.418 [error] HTTP handler crashed: exception error: {module_not_loaded,mod_conversejs,<<"localhost">>}
mar1.ejabberd  |    in function  gen_mod:get_module_opts/2 (src/gen_mod.erl, line 466)
mar1.ejabberd  |    in call from gen_mod:get_module_opt/3 (src/gen_mod.erl, line 446)
mar1.ejabberd  |    in call from mod_conversejs:get_extra_options/1 (src/mod_conversejs.erl, line 207)
mar1.ejabberd  |    in call from mod_conversejs:process/2 (src/mod_conversejs.erl, line 59)
mar1.ejabberd  |    in call from ejabberd_http:process/2 (src/ejabberd_http.erl, line 373)
mar1.ejabberd  |    in call from ejabberd_http:process_request/1 (src/ejabberd_http.erl, line 503)
mar1.ejabberd  |    in call from ejabberd_http:process_header/2 (src/ejabberd_http.erl, line 295)
mar1.ejabberd  |    in call from ejabberd_http:parse_headers/1 (src/ejabberd_http.erl, line 220)

Confirming that mod_conversejs is not loaded.

What I'm not fully understanding is that I can see this file: /opt/ejabberd-25.08/lib/ejabberd-25.8.0/ebin/mod_conversejs_opt.beam inside the Docker image. Which seems that there's a mod_conversejs_opt.beam binary file that could be used, but is not being picked up automatically on startup.

So, is there a setting that I need to add somewhere so mod_conversejs_opt.beam gets properly loaded? I've also read this discussion: mod_conversejs with ejabberd 24.10 and there seems to be a mention to a beam file (and nothing else), but that specific discussion is related to the installer, not to Docker.

Thanks again for your time,
Lucas.

[badlop]

Unable to install mod_conversejs

You don't need to install it, as it is already included with ejabberd. You just need to configure ejabberd to enable it.

I'm manually setting up the

If you provide a full reproduction guide, that describes point by point how to reproduce the problem (including Dockerfile, calls to docker, etc), then maybe somebody can get a clue what's going on in your machine.

even after running ejabberdctl modules_update_specs.

Don't do that. The module is already included in ejabberd.

{module_not_loaded,mod_conversejs,<<"localhost">>}
Confirming that mod_conversejs is not loaded.

No. That error message confirms that mod_conversejs is not loaded for "localhost" vhost. But you did not show your configuration file, so we cannot check if that vhost is enabled in your ejabberd.

I can see this file: /opt/ejabberd-25.08/lib/ejabberd-25.8.0/ebin/mod_conversejs_opt.beam

And there should also be a mod_conversejs.beam also. If it's missing, there may be a problem in the container image.

So, is there a setting that I need to add

With the small pieces of information you showed, it seems you already configured ejabberd.yml perfectly, and if you didn't break anything else, and nothing else is broken in the image (or some bug in ejabberd), then your configuration should work. But we don't know what other configurations you changed, or what other changes you made, or what volumes you mounted, and where.

If you want help to solve your problem, you should help people to understand what you did, and don't hide steps that may be relevant to the problem. For example, you can update your question providing a full step-by-step reproduction guide, that describes how to build and start the container image, how to configure ejabberd.

In summary, it seems you already did the correct configuration, but it doesn't work... so now you should explain what you did in order to reproduce the problem that you are seeing in your machine.

[lucasl84]

Hi @badlop, once again thanks for your detailed reply. I've just figured out what the issue was, actually pretty silly. In my ejabber.yml I've defined my host as:

define_macro:
  HOST: mar1.org
  ADMIN: admin
  PORT_C2S: 5222
  PORT_C2S_TLS: 5223
  PORT_S2S: 5269
  PORT_HTTP_TLS: 5443
  PORT_HTTP: 5280
  PORT_BROWSER: 1880
  PORT_STUN: 5478
  PORT_MQTT: 1883
  PORT_PROXY65: 7777

hosts:
  - HOST

But when navigating I was using: http://localhost:5280/conversejs which has to be http://mar1.org:5280/conversejs for ejabberd to resolve the host correctly. So host mismatching makes the whole thing not to work (I've now mapped mar1.org in my /etc/hosts file to localhost, as I'm just playing around locally). The error displayed: {module_not_loaded,mod_conversejs,<<"localhost">>} at least to me seems to be misleading as the module is indeed already loaded. One more thing that still surprises me is that ejabberdctl modules_available does not reveal that mod_conversejs is there, is it just built-in the reason why is not displayed? This again I believe is a misleading output.

Unfortunately I'm still fighting against some certificate issues :-(, as just after logging through the ConverseJS login, the site never finishes loading. Inspecting the Network tab in the browser reveals a NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_SECURITY, MOZILLA_PKIX_ERROR_CA_CERT_USED_AS_END_ENTITY) error:

Given the steps that you described in: Self-signed certificates not working in docker image. Do I need to generate something else with openssl to feed the browser? I know that I can manually provide certificates to it, but I'm not sure if the files generated are valid or the openssl commands need to be modified to produce other files for it. Just in case I'm also attaching the ejabberd.yml that you requested (note it has been renamed as TXT for allowing it to be uploaded):

ejabberd.txt

Once again thanks for your time and help,
Lucas.

[badlop]

The error displayed: {module_not_loaded,mod_conversejs,<<"localhost">>} at least to me seems to be misleading as the module is indeed already loaded.

The error message does not say {module_not_loaded,mod_conversejs}

The error message says {module_not_loaded,mod_conversejs,<<"localhost">>}

One more thing that still surprises me is that ejabberdctl modules_available does not reveal that mod_conversejs is there, is it just built-in the reason why is not displayed? This again I believe is a misleading output.

The API documentation says (emphasis added):

modules_available
List the contributed modules available to install

The modules that may get installed, uninstalled, upgraded, are obviously not the ones that are already included in ejabberd, but the additional ones.

---

Unfortunately I'm still fighting against some certificate issues :-(, as just after logging through the ConverseJS login, the site never finishes loading. Inspecting the Network tab in the browser reveals a NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_SECURITY, MOZILLA_PKIX_ERROR_CA_CERT_USED_AS_END_ENTITY) error:

I'm bored of using containers, so tried this directly:

1. I create a certificate as explained in Self-signed certificates not working in docker image #4448 (comment)

2. Apply those changes to the default ejabberd.yml.example from ejabberd:

diff --git a/ejabberd.yml.example b/ejabberd.yml.example
index b9df7799b..63fe5aff4 100644
--- a/ejabberd.yml.example
+++ b/ejabberd.yml.example
@@ -15,10 +15,13 @@
 ###
 
 hosts:
-  - localhost
+  - mar1test.org
 
 loglevel: info
 
+certfiles:
+  - /home/badlop/ejabberd/_build/relive/conf/mar1test.org.pem
+
 ## If you already have certificates, list them here
 # certfiles:
 #  - /etc/letsencrypt/live/domain.tld/fullchain.pem
@@ -58,6 +61,7 @@ listen:
       /bosh: mod_bosh
       /captcha: ejabberd_captcha
       /upload: mod_http_upload
+      /conversejs: mod_conversejs
       /ws: ejabberd_http_ws
   -
     port: 5280
@@ -163,6 +167,9 @@ shaper_rules:
   s2s_shaper: fast
 
 modules:
+  mod_host_meta: {}
+  mod_conversejs:
+    conversejs_resources: "/home/badlop/conversejs/12.0.0/dist"
   mod_adhoc: {}
   mod_adhoc_api: {}
   mod_admin_extra: {}

3. Register an account:

ejabberdctl register admin mar1test.org asd

4. Open URL in browser https://mar1test.org:5443/conversejs/

5. In the login window, fill account admin@mar1test.org and password asd

6. The client opens perfectly, shows empty roster and ejabberd logs:

2025-09-03 13:25:15.761194+02:00 [info] (websocket|<0.2938.0>)
  Accepted c2s SCRAM-SHA-512 authentication for admin@mar1test.org
  by mnesia backend from ::ffff:127.0.0.1
2025-09-03 13:25:15.799047+02:00 [info] (websocket|<0.2938.0>)
  Opened c2s session for admin@mar1test.org/converse.js-4277208

[lucasl84]

Hi @badlop, thanks for all this detailed information. I'm also tired of docker as well (I honestly dislike it), but I have no choice. I will do my best to check that ejabberd works in a non dockerized environment as you shown. I'm sorry for my wrong assumptions about what is contributed & built-in. Indeed I thought that mod_conversejs was a contributed module as it looks like an independent project to me.

Thanks for your time,
Lucas.