view mod_extdisco/README.md @ 6513:5fb466693e85

mod_storage_xmlarchive: Ensure list index files are removed using os.remove() on the list files leaves the new index files behind since util.datamanager does not know they are removed. Thanks Link Mauve
author Kim Alvefur <zash@zash.se>
date Tue, 07 Apr 2026 21:10:54 +0200
parents 8d75d5f82a83
children
line wrap: on
line source

---
summary: External Service Discovery
superseded_by: mod_external_services
labels:
- 'Stage-Obsolete'
...


::: {.alert .alert-warning}
This module is obsolete, please use [mod_external_services] (nearly exact replacement) 
or [mod_turn_external] (narrow scope for turn), both included in prosody.
:::

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

This module adds support for [XEP-0215: External Service Discovery],
which lets Prosody advertise non-XMPP services.

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

Example services from the XEP:

``` {.lua}
modules_enabled = {
    -- other modules ...
    "extdisco";
}

external_services = {
    ["stun.shakespeare.lit"] = {
        port="9998";
        transport="udp";
        type="stun";
    };
    ["relay.shakespeare.lit"] = {
        password="jj929jkj5sadjfj93v3n";
        port="9999";
        transport="udp";
        type="turn";
        username="nb78932lkjlskjfdb7g8";
    };
    ["192.0.2.1"] = {
        port="8888";
        transport="udp";
        type="stun";
    };
    ["192.0.2.1"] = {
        port="8889";
        password="93jn3bakj9s832lrjbbz";
        transport="udp";
        type="turn";
        username="auu98sjl2wk3e9fjdsl7";
    };
    ["ftp.shakespeare.lit"] = { 
        name="Shakespearean File Server";
        password="guest";
        port="20";
        transport="tcp";
        type="ftp";
        username="guest";
    };
}
```

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

Incompatible with
[mod_turncredentials](https://modules.prosody.im/mod_turncredentials).