mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Updating XMPP (_en) docs to make explicit how to use XMPP account.
This commit is contained in:
Bernard
parent
c2a8e26a08
commit
5918357a6c
1 changed files with 33 additions and 24 deletions
57
XMPP.md
57
XMPP.md
|
|
@ -1,53 +1,62 @@
|
|||
# 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)
|
||||
- [Libervia/Salut à Toi](http://salut-a-toi.org/).
|
||||
|
||||
|
||||
### Desktop clients
|
||||
|
||||
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),
|
||||
- [Dino](https://dino.im) (Linux),
|
||||
- [Thunderbird](https://www.thundebird.net/) (multiplatform),
|
||||
- [Jitsi](http://jitsi.org/) (multiplatform)
|
||||
- [Thunderbird](https://www.thundebird.net/) (multiplatform),
|
||||
- [Jitsi](http://jitsi.org/) (multiplatform)
|
||||
- [Adium](https://adium.im/) (Mac OS).
|
||||
|
||||
... or a mobile client
|
||||
* [Xabber](http://xabber.com) (Android)
|
||||
* [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)
|
||||
### Mobile clients
|
||||
|
||||
Or a mobile client such as:
|
||||
- [Xabber](http://xabber.com) (Android)
|
||||
- [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
|
||||
|
||||
### 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 :
|
||||
* Install `gajim` and the plugin `gajim-omemo`
|
||||
* Enable the plugin in `Tools > Plugins`
|
||||
* Enable it
|
||||
* Enable the encryption in the chat with somebody who also has OMEMO
|
||||
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`
|
||||
- Enable the plugin in `Tools > Plugins`
|
||||
- Enable it
|
||||
- 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`.
|
||||
|
||||
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/).
|
||||
|
|
|
|||
Loading…
Reference in a new issue