This documentation use an anonymousaccount to connect the bridge to the chat.But since the livechat v10.1.0, there is a new way to generate long term authentication token, that allows to connect using youraccount.Thisis used for [OBS docks](/peertube-plugin-livechat/documentation/user/obs).Using this feature for other purposes isnot documented and not officially supported yet.If you want to use it anyway, youcan request a token by calling then `/plugins/livechat/router/api/auth/tokens` endpoint.To get needed headers and request body, just check what happens when you generate a new token for OBS docks.
This chat module is based onthe XMPP protocol, also known as Jabber.It is therefore possible to connect to the chats using [XMPP client software](https://en.wikipedia.org/wiki/XMPP#Clients).Thiscan for example be useful to facilitate moderation operations.
For theuser documentation associated with these features, please refer to the [user documentation page](/peertube-plugin-livechat/documentation/user/xmpp_clients/).
Enabling these features requires configuration changes onthe server, and onthe DNS records.It isnot possible to configure thisonly from the Peertube interface, and it requires some basic system some basic system admin skills.
To enable this feature, you will need to set up your server and DNS records, so that XMPP clients can find and access the [Prosody server](https://prosody.im) that this plugin uses internally.
Start by going to the livechat plugin settings of yourinstance, then enable the setting "Enable connection to room using external XMPP accounts".By checking this setting, new settings appear below.
First of all, the "Prosody server to server port" field.This one defaults to 5269, which isthe standard port for this service.Youcan however change to another port, if thisis already in use onyour server.
Next, the field "Server to server network interfaces" field allows you to specify which network interfaces the server should listen on.The default value "*, ::" indicates to listen on all IP addresses.Youcan change these values, if you wish to listen ononly certain IP addresses.The syntax is explained next to the setting.
For the "Certificate folder" setting, youcan leave it empty.In this case, the plugin will automatically generate self-signed certificates.Some XMPP servers may refuse to connect, depending on their configuration.In this case, youcan indicate here a path onthe server, in which you must place certificates to be used by the module.It is up to you to generate and renew them.See bellow for more information.