view mod_http_upload/README.markdown @ 2284:1266f5c17c0d

mod_http_upload: Mention modules_enabled, but no example
author Kim Alvefur <>
date Sat, 20 Aug 2016 18:33:43 +0200
parents e276ed33bc1a
children 8fad27d568aa
line wrap: on
line source

description: HTTP File Upload
labels: 'Stage-Alpha'


This module implements [XEP-0363], which lets 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][doc:http]
for information about how to configure ports, HTTP Host names etc.

The module can be added as a new Component definition:

``` {.lua}
Component "" "http_upload"

Alternatively it can be added to `modules_enabled` like other modules.


A maximum file size can be set by:

``` {.lua}
http_upload_file_size_limit = 123 -- bytes

Default is 1MB (1024\*1024).


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

``` {.lua}
http_upload_path = "/path/to/uploded/files"


Works with Prosody 0.9.x and later.