Prosody is a modern XMPP communication server. It aims to be easy to set up and configure, and efficient with system resources. Additionally, for developers it aims to be easy to extend and give a flexible system on which to rapidly develop added functionality, or prototype new protocols.

ℹ️ Important note

This app installs Prosody from Debian packages. Basically, this means that you will not benefit from the latest versions of Prosody but benefit the stability and security of the Debian packaging. Read more about this choice in RATIONALE.md.

🚀 Target is to provide at least:

• A/V calls (https://github.com/YunoHost/issues/issues/1607)
• BOSH (https://forum.yunohost.org/t/unable-to-set-up-bosh-conf-nginx/12995)
• invite links (if not covered by https://github.com/YunoHost/issues/issues/1677)
• File sharing for all usual filetypes (https://forum.yunohost.org/t/metronome-mime-types-for-metronome-again/20073)

...and ultimately an Advanced Server compliance level (https://xmpp.org/extensions/xep-0479.html).

✅ What works:

• install on Yunohost 12
• LDAP auth
• A/V calls
• File upload
• MUC
• optional import of rosters, MUCs, bookmarks from Metronome (integrated service on Yunohost 11 or app on Yunohost 12) (pep is not supported, #12)
• automatically install coturn if not yet present
• XEP-0156, XEP-0163, XEP-0191, XEP-0215, XEP-0237, XEP-0280, XEP-0313, XEP-0363 (see 'xmpp_compliance' file), XEP-0421 TBC

🐞 What does not work:

• vjud (Users directory) (help welcomed!)

🙋 TODO (help welcomed!):

• usability by other apps:
  • PeerTube: to be tested
  • Movim: app currently broken
  • Converse.js: seems to work 🥳
  • Jitsi: reported to work 🥳
  • Nextcloud: to be tested
  • Libervia: to be tested non-working app
  • biboumi: currently not working
  • ...?
• check initial configuration (DNS, ?) : information via PRE_INSTALL.md

READ before install!

Ideally all the README :) but this in particular:

• You must ensure that your DNS configuration includes the subdomains muc., xmpp-upload. and pubsub.
• You should not create Yunohost subdomains muc., xmpp-upload. and pubsub.

App conflicts/dependencies

Conflict

• Metronome : you have to deinstall Metronome app before to install this app (using the same ports)
• Simplex : you have to deinstall Simplex app before to install this app (using the same ports)

Sequencing

• Jitsi : if you want to have both Jitsi and Prosody on your server, you must install first the Prosody app, then the Jitsi app

Dependencies

• coturn : it will be automatically installed if needed

Additionnal infos

• Users connect on XMPP with their email address. Ensure in the Yunohost Users configuration panel they have an email address matching the domain on which you install Prosody. If not add an email alias.

💬 Further discussions, support on xmpp:yunohost-xmpp@muc.chapril.org?join Or in the forum.