view mod_http_upload/README.markdown @ 2053:40056a27f394

mod_http_upload: Lower default size limit to 1MB
author Kim Alvefur <>
date Wed, 24 Feb 2016 15:59:18 +0100
parents ad2966b932ed
children e276ed33bc1a
line wrap: on
line source

labels: Stage-Alpha
description: HTTP File Upload


This module implements [XEP-0363], which lets clients upload files over


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 either be configured as a component or added to an
existing host or component. Possible configuration variants are as


You can configure it as a standalone component:

    Component "" "http_upload"

Existing component

Or add it to an existing component:

    Component "" "proxy65"
    modules_enabled = {

On VirtualHosts

Or load it directly on hosts:

    -- In the Global section or under a specific VirtualHosts line
    modules_enabled = {
      -- 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.