2020-11-11 11:47:10 +01:00
---
title: Chat, VoIP and social network with XMPP
template: docs
taxonomy:
category: docs
2021-02-06 18:22:00 +01:00
routes:
default: '/XMPP'
2020-11-11 11:47:10 +01:00
---
2021-02-06 22:41:01 +01:00
2014-05-31 08:19:36 +02:00
2020-10-17 15:02:38 +02:00
By default, YunoHost comes installed with an instant messaging server called Metronome which implements the [XMPP protocol ](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol ) (previously known as Jabber).
2014-05-31 08:19:36 +02:00
2020-10-17 15:02:38 +02:00
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.
2014-05-31 08:19:36 +02:00
2020-10-17 15:02:38 +02:00
XMPP is an extensible protocol—this means users can configure "extensions" to chatrooms, share messages and files, and make voice and video calls using XMPP.
2014-05-31 08:19:36 +02:00
2019-10-13 21:35:03 +02:00
## XMPP account
2014-09-25 11:43:31 +02:00
2020-10-17 15:02:38 +02:00
To use an XMPP account you need a username, in the format: `user@domain.tld` , and a password.
2014-09-25 11:43:31 +02:00
2020-10-17 15:02:38 +02:00
With YunoHost, an XMPP account is created for all YunoHost users automatically.
The XMPP account credentials corresponds to the user's main e-mail address and password.
2018-08-27 20:48:33 +02:00
2019-10-13 21:35:03 +02:00
## Connecting to your YunoHost XMPP account
2018-08-27 20:48:33 +02:00
2019-10-13 21:35:03 +02:00
You can connect to your YunoHost XMPP account in different ways.
### Web clients
2020-04-04 13:36:13 +02:00
- [Movim ](https://movim.eu )
- [ConverseJS ](https://conversejs.org/ )
- [Libervia/Salut à Toi ](https://salut-a-toi.org/ )
2019-10-13 21:35:03 +02:00
### Desktop clients
2020-10-17 15:02:38 +02:00
- [Gajim ](https://gajim.org/ ) (Linux, Windows)
2020-04-04 13:36:13 +02:00
- [Dino ](https://dino.im ) (Linux)
- [Thunderbird ](https://www.thunderbird.net/fr/ ) (multiplatform)
2020-09-22 21:51:19 +02:00
- [Beagle IM ](https://beagle.im/ ) (macOS)
2020-04-04 13:36:13 +02:00
- [Profanity ](https://profanity-im.github.io/ ) (Linux)
2018-08-27 20:48:33 +02:00
2019-10-13 21:35:03 +02:00
### Mobile clients
- [Conversations ](https://conversations.im/ ) (Android)
2020-10-17 15:02:38 +02:00
- [Xabber ](https://xabber.com ) (Android)
2020-09-22 21:51:19 +02:00
- [Movim ](https://movim.eu ) (Android)
2021-01-19 08:55:25 +01:00
- [ChatSecure ](https://chatsecure.org/ ) (iOS)
2020-04-04 13:36:13 +02:00
- [Monal ](https://monal.im/ ) (iOS)
- [Siskin IM ](https://siskin.im/ ) (iOS)
- [Kaidan ](https://www.kaidan.im/ ) (Ubuntu Touch / Plasma Mobile)
2018-08-27 20:48:33 +02:00
2020-09-22 21:51:19 +02:00
Here is an exhaustive list of XMPP clients: https://xmpp.org/software/clients.html
2018-08-27 20:48:33 +02:00
2019-10-13 21:35:03 +02:00
## Encrypt conversations with OMEMO
2018-08-27 20:48:33 +02:00
2020-06-27 14:32:18 +02:00
XMPP chats can be made secure and private using [OMEMO encryption ](https://xmpp.org/extensions/xep-0384.html ), for instance using Gajim:
2020-10-17 15:02:38 +02:00
- Install `gajim` and the plugin `gajim-omemo` .
- Turn on the plugin in `Tools > Plugins` .
- Turn on the encryption in the chat with somebody who also has OMEMO.
2018-08-27 20:48:33 +02:00
2019-10-13 21:35:03 +02:00
## Chatrooms
2018-08-27 20:48:33 +02:00
To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld` .
2020-03-28 06:54:10 +01:00
For this to work you need to [add the corresponding `muc.` DNS record ](/dns_config ) in the DNS configuration.
2018-08-27 20:48:33 +02:00
2019-10-13 21:35:03 +02:00
## VoIP and videoconferences
2018-08-27 20:48:33 +02:00
2020-10-17 15:02:38 +02:00
A practical tool to call an XMPP client, either with voice or voice+video, is to use the [Jitsi ](https://jitsi.org/ ) client.
