view mod_mam_muc/README.markdown @ 1958:eb515fbac198

mod_mam_muc/README: Automagic links!
author Kim Alvefur <>
date Thu, 10 Dec 2015 16:31:58 +0100
parents 79b9bd84b91c
children 5be671db83a3
line wrap: on
line source

- 'Stage-Alpha'
summary: 'XEP-0313: Message Archive Management for MUC'


This module logs the conversation of chatrooms running on the server to
Prosody's archive storage. To access them you will need a client with
support for [XEP-0313: Message Archive Management] or a module such
as [mod\_http\_muc\_log].


First copy the module to the prosody plugins directory.

Then add "mam\_muc" to your modules\_enabled list:

``` {.lua}
Component "" "muc"
modules_enabled = {
storage = {
  -- This makes mod_mam_muc use the sql2 storage backend (others will use internal)
    -- which at the time of this writing is the only one supporting stanza archives
    muc_log = "sql2";

See [Prosodys data storage
documentation]( for more info on how to
configure storage for different plugins.


Logging needs to be enabled for each room in the room configuration

``` {.lua}
muc_log_by_default = true; -- Enable logging by default (can be disabled in room config)

muc_log_all_rooms = false; -- set to true to force logging of all rooms

-- This is the largest number of messages that are allowed to be retrieved in one MAM request.
max_archive_query_results = 20;

-- This is the largest number of messages that are allowed to be retrieved when joining a room.
max_history_messages = 1000;


  ------- ---------------
  trunk   Works
  0.10    Works
  0.9     Does not work
  0.8     Does not work
  ------- ---------------