view mod_http_upload/README.markdown @ 1851:03c5639882a7

mod_http_upload: Add support for a file size limit
author Kim Alvefur <>
date Mon, 14 Sep 2015 12:49:54 +0200
parents cd98a1103ecf
children 8e5ee3b09e9d
line wrap: on
line source


This module provides a space for clients to upload files over HTTP, as
used by [Conversations](


The module can either be configured as a component or added to an
existing host or component.

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.


Standalone component:

    Component "" "http_upload"

Existing component

    Component "" "proxy65"
    modules_enabled = {

On VirtualHosts

    -- 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 = 10 * 1024 * 1024 -- this is 10MB in bytes


Works with Prosody 0.9.x and later.