view mod_migrate_http_upload/README.markdown @ 5516:f25df3af02c1

mod_client_management: Include client software version number in listing Should you ever wish to revoke a client by version number, e.g. for security reasons affecting certain versions, then it would be good to at the very least see which version is used. Also includes the OAuth2 software ID, an optional unique identifier that should be the same for all installations of a particular software.
author Kim Alvefur <zash@zash.se>
date Sat, 03 Jun 2023 19:21:39 +0200
parents 6844733ad2f5
children
line wrap: on
line source

---
summary: mod_http_upload to mod_http_file_share migrator
labels:
- Stage-Alpha
---


This is a migration script for converting records of [mod_http_upload]
into the format used by the new [mod_http_file_share][doc:modules:mod_http_file_share]
which will be available with Prosody 0.12 (currently in trunk).

# Usage

If your main `VirtualHost` is called "example.com" and your HTTP upload
`Component` is called "upload.example.com", then this command would
convert records of existing uploads via [mod_http_upload] to
[mod_http_file_share][doc:modules:mod_http_file_share]:

```bash
sudo prosodyctl mod_migrate_http_upload upload.example.com example.com
```

In order to preserve URLs you will need to configure the
[path][doc:http#path_configuration] to be the same as mod_http_upload:

```lua
Component "upload.example.com" "http_file_share"
http_paths = {
    file_share = "/upload"
}
```