#summary Log chatroom messages to disk

#labels Stage-Beta

= Introduction =

This module logs the conversation of chatrooms running on the server to Prosody's data store. To view them you will need a module such as [mod_muc_log_http].

= Details =

mod_muc_log must be loaded individually for the components that need it. Assuming you have a MUC component already running on conference.example.org then you can add muc_log to it like so:

{{{

Component "conference.example.org" "muc"

   modules_enabled = {

      "muc_log";

   }

}}}

Logging is not enabled by default.  In 0.9+ logging can be enabled per room in the room config form.

To enable logging in older versions, or to enable logging by default for all rooms, set

{{{

muc_log_by_default = true -- Log all rooms by default

}}}

= Compatibility =

|| 0.6 || Works ||

|| 0.7 || Works ||

|| 0.8 || Works ||

|| 0.9 || Works ||

*Note* that per-room configuration only works in 0.9+.