YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Updating XMPP (_en) docs to make explicit how to use XMPP account.

Browse source
This commit is contained in:
Bernard 2019-10-13 20:35:03 +01:00
parent c2a8e26a08
commit 5918357a6c
1 changed files with 33 additions and 24 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

51
XMPP.md
View file

@ -1,23 +1,30 @@
# Chat, VoIP and social network with <img src="/images/XMPP_logo.png" width=100> # Chat, VoIP and social network with <img src="/images/XMPP_logo.png" width=100>
YunoHost comes installed with an instant messaging server Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol). YunoHost comes installed with an instant messaging server Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol)(previously known as Jabber), by default.
XMPP is an open and extensible protocol which allows to create chatrooms, to share status and data, to give calls in VoIP and videoconferences. This protocol is already used by millions of people around the world - it is an open protocol. All applications based on XMPP are compatible with each other: when using an XMPP client, you can interact with anybody who has an XMPP account.
All applications based on XMPP are compatible with each other : when using an XMPP client, you can interact with anybody who has an XMPP/Jabber account. This protocol is already used by millions of people around the world. XMPP is an extensible protocol - this means users can configure "extensions" to chatrooms, to share messages and files, and to make voice and video calls using XMPP.
### XMPP/Jabber account ## XMPP account
An XMPP/Jabber account is based on an identifier with the structure `user@domain.tld`, and a password. To use an XMPP account you need a username, which takes the format: `user@domain.tld`, and a password.
In YunoHost, this identifier simply corresponds to the main email address of a user, with his regular password. With YunoHost, an XMPP account is created for a registered account automatically. The XMPP account can be used with the main email address and her YunoHost password.
### Connecting to XMPP ## Connecting to your YunoHost XMPP account
There are several web client built with social network features : You can connect to your YunoHost XMPP account in different ways.
### Web clients
There are several XMPP web clients:
- [Movim](https://pod.movim.eu) - [Movim](https://pod.movim.eu)
- [Libervia/Salut à Toi](http://salut-a-toi.org/). - [Libervia/Salut à Toi](http://salut-a-toi.org/).
### Desktop clients
You can also use a desktop client such as : You can also use a desktop client such as :
- [Pidgin](http://pidgin.im/) (multiplatform), - [Pidgin](http://pidgin.im/) (multiplatform),
- [Gajim](http://gajim.org/) (Linux, Windows), - [Gajim](http://gajim.org/) (Linux, Windows),
@ -26,28 +33,30 @@ You can also use a desktop client such as :
- [Jitsi](http://jitsi.org/) (multiplatform) - [Jitsi](http://jitsi.org/) (multiplatform)
- [Adium](https://adium.im/) (Mac OS). - [Adium](https://adium.im/) (Mac OS).
... or a mobile client ### Mobile clients
* [Xabber](http://xabber.com) (Android)
* [Conversations](https://conversations.im/) (Android) Or a mobile client such as:
* [Movim under Android](https://movim.eu) - [Xabber](http://xabber.com) (Android)
* [Monal](https://itunes.apple.com/us/app/monal-free-xmpp-chat/id317711500?mt=8) (iOS) - [Conversations](https://conversations.im/) (Android)
- [Movim under Android](https://movim.eu)
- [Monal](https://itunes.apple.com/us/app/monal-free-xmpp-chat/id317711500?mt=8) (iOS)
Here is an exhaustive list of XMPP clients : https://en.wikipedia.org/wiki/Comparison_of_XMPP_clients Here is an exhaustive list of XMPP clients : https://en.wikipedia.org/wiki/Comparison_of_XMPP_clients
### Encrypt conversations with OMEMO ## Encrypt conversations with OMEMO
XMPP chats can be encrypted with the help of [OMEMO](https://xmpp.org/extensions/xep-0384.html), for instance using Gajim : XMPP chats can be made secure and private using [OMEMO] encryption (https://xmpp.org/extensions/xep-0384.html), for instance using Gajim:
* Install `gajim` and the plugin `gajim-omemo` - Install `gajim` and the plugin `gajim-omemo`
* Enable the plugin in `Tools > Plugins` - Enable the plugin in `Tools > Plugins`
* Enable it - Enable it
* Enable the encryption in the chat with somebody who also has OMEMO - Enable the encryption in the chat with somebody who also has OMEMO
### Chatrooms ## Chatrooms
To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`. To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`.
For this to work you need to [add the corresponding `muc.` DNS record](dns_config_fr) in the DNS configuration. For this to work you need to [add the corresponding `muc.` DNS record](dns_config_fr) in the DNS configuration.
### VoIP and videoconferences ## VoIP and videoconferences
A practical tool to call an XMPP client, either with voice or voice+video, is to use the client [Jitsi](http://jitsi.org/). A practical tool to call an XMPP client, either with voice or voice+video, is to use the client [Jitsi](http://jitsi.org/).