view mod_http_upload/README.markdown @ 2273:677fc0203da0

mod_filter_words: Very basic module in its early stages, to filter words in messages
author Matthew Wild <mwild1@gmail.com>
date Thu, 18 Aug 2016 10:25:29 +0100
parents e276ed33bc1a
children 1266f5c17c0d
line wrap: on
line source

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

Introduction
============

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

Configuration
=============

mod\_http\_upload relies on Prosodys HTTP server and mod\_http for
serving HTTP requests. See [Prosodys HTTP server
documentation](https://prosody.im/doc/http) for information about how to
configure ports, HTTP Host names etc.

Simply add a new Component definition:

    Component "upload.example.org" "http_upload"

Limits
------

A maximum file size can be set by:

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

Default is 1MB (1024*1024).

Path
----

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"
```

Compatibility
=============

Works with Prosody 0.9.x and later.