peertube-plugin-livechat/documentation/installation.md

22 lines
1.5 KiB
Markdown
Raw Normal View History

2021-11-04 12:57:37 +00:00
# Plugin peertube-plugin-livechat installation guide 🇬🇧
2021-11-04 12:59:52 +00:00
🇫🇷 French version / Version française [ici](./installation.fr.md)
2022-04-02 22:24:33 +00:00
🇩🇪 German version / deutsche Version [hier](./installation.de.md)
2021-11-04 12:57:37 +00:00
**IMPORTANT:** unfortunately this plugin does not (yet) work by itself, it must rely on external tools.
**Before updating to a major release, please read the release notes and breaking changes list : [CHANGELOG](../CHANGELOG.md)**.
This plugin can be used in different ways:
| Mode | Description | Documentation
---|---|---
2021-11-04 13:53:23 +00:00
**Prosody server controlled by Peertube (recommended)** | This plugin can launch a [Prosody](https://prosody.im) process and auto-configure it | [Prosody+Peertube installation](./prosody.md). **This is the recommanded mode, and is almost automatic to setup**
2021-11-04 13:50:33 +00:00
**Connect to an existing XMPP server with ConverseJS** | You can use an external Jabber/XMPP server. This server has to provide BOSH or Websocket API, accept anonymous login, and accept room creation. | [ConverseJS+XMPP installation](./conversejs.md)
**Use an external web chat tool** | You can use any external web chat tool, that can be included in an iframe. | [External chat installation](./external.md)
2021-11-04 12:57:37 +00:00
For the two first solutions, the connection to the XMPP server is made with the [converseJS](https://conversejs.org/) Javascript library.
XMPP is a protocol for chat applications. It is sometime known has Jabber.
There are some documentation for common settings here: [common settings documentation](./common.md).