This module implements XEP-0363, versions 0.2 and 0.3, which let clients upload files over HTTP.


mod_http_upload relies on Prosodys HTTP server and mod_http for serving HTTP requests. See Prosodys HTTP server documentation for information about how to configure ports, HTTP Host names etc.

The module can be added as a new Component definition:

Component "" "http_upload"

Alternatively it can be added to modules_enabled like other modules.


A maximum file size can be set by:

http_upload_file_size_limit = 123 -- bytes

Default is 1MB (1024*1024).

This can not be set over the value of http_max_content_size (default 10M).


By default, uploaded files are put in a sub-directory of the default Prosody storage path (usually /var/lib/prosody). This can be changed:

http_upload_path = "/path/to/uploded/files"


Works with Prosody 0.9.x and later.