Prosody for YunoHost

⚠️ This is a fork (work in progress) of the official Prosody app to install on Yunohost 12 and aiming at providing the best XMPP support possible!

This app is in Beta maturity (reported to work by several people, though few manual operations might be needed and some functionalities are still missing).

🚀 Target is to provide at least:

• A/V calls (YunoHost/issues#1607)
• BOSH (https://forum.yunohost.org/t/unable-to-set-up-bosh-conf-nginx/12995)
• invite links (if not covered by YunoHost/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 (https://github.com/anubister/coturn_ynh/ , a fork compatible with Yunohost 12)
• 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!):

• if applicable manage migration from upstream version of coturn app
• usability by other apps:
  • PeerTube: to be tested
  • Movim: app broken?
  • Converse.js: seems to work
  • Jitsi: to be tested
  • Nextcloud: to be tested
  • Libervia: to be tested non-working app
  • ...?
• check initial configuration (DNS, ?) : inform or block?
• update scripts/remove and others...
• check/improve app score

READ before install!

Ideally all the README :) but this in particular:

• You must ensure that your DNS configuration includes the subdomains muc. and xmpp-upload.
• You should not create Yunohost subdomains muc. and xmpp-upload.
• You must apply the workaround for this bug : #4 (comment)
• You have to deinstall Metronome app before to install this app (using the same ports).

💬 Further discussions, support on xmpp:[email protected]?join Or in the forum.

ℹ️ About this branch This package / branch installs from the Debian packages repository prosody and prosody-modules (no compilation on server-side). It installs on your desired (sub)domain selected during the installation.

Overview

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.

Shipped version: 0.12.4

Documentation and resources

• Official app website: https://prosody.im/
• Official admin documentation: https://prosody.im/doc
• Upstream app code repository: https://hg.prosody.im/
• Report a bug: https://github.com/anubister/prosody_ynh/issues
• Forum announcement: https://forum.yunohost.org/t/prosody-xmpp-server-for-yunohost-12/

Contributor info

Please send your pull request to the install-from-debian branch or install-from-source branch.

To try this unofficial app:

sudo yunohost app install https://github.com/anubister/prosody_ynh/tree/master --debug

Enjoy 🥳 or report your bug!

More info regarding app packaging: https://yunohost.org/packaging_apps