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


If your main VirtualHost is called “” and your HTTP upload Component is called “”, then this command would convert records of existing uploads via mod_http_upload to mod_http_file_share:

sudo prosodyctl mod_migrate_http_upload

In order to preserve URLs you will need to configure the path to be the same as mod_http_upload:

Component "" "http_file_share"
http_paths = {
    file_share = "/upload"


With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server= mod_migrate_http_upload

For earlier versions see the documentation for installing 3rd party modules