Quitter le mode Zen
236
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Fenced code block (bash)
$ dig +short _xmpp-server._tcp.room.videos.john-livingston.fr. SRV
0 5 5269 videos.john-livingston.fr.

$ dig +short _xmpp-server._tcp.external.videos.john-livingston.fr. SRV
0 5 5269 videos.john-livingston.fr.
0/2110 · 211
237
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
If you are **not using the standard `5269` port**, you must also add a SRV record for `_xmpp-server._tcp.your_instance.tld.` (same as above, just without the `room.` prefix). Of course, you can also add this record if you use the standard port. It will also work.
0/2640 · 264
238
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Title ###
Using trusted certificates
0/260 · 26
239
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
The self-signed certificates that this plugin uses by default can be rejected by some XMPP servers, for security reasons.
0/1210 · 121
share_chat_dock_tips
Anglais
You can generate a link that will open the chat in full page, logged in with your Peertube account.
This can be use, for example, to have a web dock in your OBS, so you can read and interact with the chat directly from OBS.
Don't share this link to anyone, as it would allow them to connect as yourself.
Please find bellow the list of authentication token you have already generated.
You can create a new one, or revoke any previous token.
Please note that these tokens have no expiration date.
0/4950 · 495
240
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
It is possible to use certificates validated by a certification authority. However, this requires advanced system administration knowledge. Indeed, due to the multitude of possible use cases, it is impossible to document all situations here. This documentation will therefore only explain the goal to be reached, and give an example which will only be suitable for a "basic" situation (manual installation of Peertube, using letsencrypt). If you are in another situation (Docker installation, certificates signed by another authority, etc...), you will have to adapt this approach by yourself.
0/5970 · 597
241
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Title ####
Basic principle
0/150 · 15
242
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
It is up to you to generate valid certificates for domains `your_instance.tld` and `room.your_instance.tld`. You can use any [method supported by Prosody](https://prosody.im/doc/certificates).
0/1930 · 193
243
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
You must then place these certificates in a folder that will be accessible to the `peertube` user, and specify this folder in the plugin setting "Certificate folder".
0/1660 · 166
244
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
If you want to use the ProsodyCtl utility to import certificates, this utility is available (once Peertube is started) using the following command (adapting the path to your Peertube data folder, and replacing "xxx" with the arguments you wish to pass to prosodyctl): `sudo -u peertube /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosodyAppImage/squashfs-root/AppRun prosodyctl --config /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosody/prosody.cfg.lua xxx`
0/4990 · 499
245
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
The plugin will check once a day to see if any files have been modified in this folder, and reload Prosody if necessary.
0/1200 · 120
246
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Title ####
Method for the simple case
0/260 · 26
247
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
We assume here that your Peertube installation is "classic" (no use of Docker), and that the certificates are generated by letsencrypt, using the certbot tool.
0/1590 · 159
248
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
First of all, we'll have to create a certificate for the subdomain `room.your_instance.tld` : this is the uri of the MUC (XMPP chat rooms) component. Even if the connections are made on `your_instance.tld`, we will need a valid certificate for this subdomain.
0/2600 · 260
249
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
So start by setting up a DNS entry for `room.your_instance.tld`, which points to your server. You can use a CNAME entry (or an A entry and a AAAA entry).
0/1540 · 154
livechat_token_disabled_description
Anglais
Users can generate long term tokens to connect to the chat.
These tokens can for example be used to include the chat in OBS web docks.
Check <a href="https://livingston.frama.io/peertube-plugin-livechat/documentation/user/obs" target="_blank">the documentation</a> for more information.
You can disable this feature by checking this setting.
0/3420 · 342
250
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
Next, we'll use nginx (already installed for your Peertube) to generate the certbot certificate. We will create a new site. In the file `/etc/nginx/site-available/room.peertube`, add:
0/1840 · 184
251
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Fenced code block (nginx)
server {
listen 80;
listen [::]:80;
server_name room.your_instance.tld;

location /.well-known/acme-challenge/ {
default_type "text/plain";
root /var/www/certbot;
}
location / { return 301 https://your_instance.tld; }
}
0/2400 · 240
252
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
Then enable the site:
0/210 · 21
254
support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
Anglais type: Plain text
Then we prepare the folder in which we will later import the certificates. We assume here that you already have the plugin active. We will create the following folder (if it doesn't already exist), with the user `peertube` to make sure there are no permissions issues:
0/2690 · 269