31 Configure Prosody
Jaussoin Timothée edited this page 2026-02-01 10:42:16 +01:00

The prosody documentation is quite complete and we recommend you read it when configuring your server.

HTTP Upload

For files/images upload Movim requires HTTP upload service, for Prosody available as community modules:

PEP and PubSub

Movim requires that your PEP and PubSub modules accept a high number of items.

The default value for max_items in a node in Prosody is 1. Prosody limits the maximum number of items that can be configured on a Pubsub/PEP node to 256 by default. To change this, you can set pubsub_max_items and pep_max_items in your configuration file.

expose_publisher = true is also required to allow Movim to know the original JID of the posts and comments/likes and trust them.

-- In the global section, or in your VirtualHost
pep_max_items = 10000

-- For your PubSub component
Component "pubsub.example.com" "pubsub"
    pubsub_max_items = 10000
    expose_publisher = true

You can also setup multiple Pubsub service by declaring multiple components with different hostnames.

Configuration of the comments service

Follow the comments.domain.name advice and configure it with expose_publisher = true as well to ensure that Movim knows the JID of the comments and likes authors.

You must configure the comments.domain.name service to allow anyone to create a comments node on it.

Component "comments.domain.name" "pubsub"
  expose_publisher = true
  -- Allow anyone to create a node
  add_permissions = {
      ["prosody:guest"] = { "pubsub:create-node" }
  }

More information there: https://prosody.im/doc/modules/mod_pubsub#common-permission-configurations

Prosody's limitations:

  • Prosody doesn't support XEP-0059 for PubSub, thus pagination in nodes will not work (see issue).

For more information, https://prosody.im/doc/modules/mod_pubsub and https://prosody.im/doc/modules/mod_pep.

Contact Addresses

https://prosody.im/doc/modules/mod_server_contact_info