This module allows you to monitor the state of hosts and components in your Prosody server. For example, it will track whether components are connected and (if the component supports it) listen for heartbeats sent by the component to indicate that it is functioning.

This module does not expose any interface to access the status information itself. See mod_http_host_status_check for a module that allows you to access host status information over HTTP(S).


There are no configuration options for this module.

You should enable it on every host that you want to monitor, by adding it to modules_enabled. Note that to monitor components, adding to the global modules_enabled list will not suffice - you will need to add it to the component’s own modules_enabled, like this:

Component ""
   modules_enabled = { "host_status_check" }


Works with Prosody 0.9.x and later.


With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server= mod_host_status_check

For earlier versions see the documentation for installing 3rd party modules