mod_storage_mongodb/README.markdown
author Matthew Wild <mwild1@gmail.com>
Tue, 18 Jan 2022 17:01:18 +0000
changeset 4880 0f5f2d4475b9
parent 1824 8de50be756e5
permissions -rw-r--r--
mod_http_xep227: Add support for import via APIs rather than direct store manipulation In particular this transitions PEP nodes and data to be imported via mod_pep's APIs, fixing issues with importing at runtime while PEP data may already be live in RAM. Next obvious candidate for this approach is rosters, so clients get immediate roster pushes and other special handling (such as emitting subscribes to reach the desired subscription state).

---
labels:
- 'Type-Storage'
- 'Stage-Alpha'
summary: MongoDB Storage Module
...

Introduction
============

This is a storage backend that uses MongoDB. Depends on [luamongo
bindings](https://github.com/mwild1/luamongo)

This module is not under active development and has a number of issues
related to limitations in MongoDB. It is not suitable for production
use.

Configuration
=============

Copy the module to the prosody modules/plugins directory.

In Prosody's configuration file, set:

    storage = "mongodb"

MongoDB options are:

  Name         Description
  ------------ -------------------------------------------------------------------
  server       hostname:port
  username     your username for the given database
  password     your password for the given database (either raw or pre-digested)
  is\_digest   whether the password field has been pre-digested

Compatibility
=============

  ------- ---------------------------
  trunk   Untested, but should work
  ------- ---------------------------