- Shell 100%
Thovi98's review on YunoHost/apps#3573 flagged files that have no business in a packaged app. They were project-workspace artifacts that rode along because this repo root doubles as the app: - docs/ (bake-off decision doc, design spec, implementation plan) -- moved to project-chat/docs/ejabberd/, where the rest of the XMPP decision history lives. - myproject.toml -- local project-catalogue metadata, meaningless to YunoHost. Not relocated to conf/ as suggested; conf/ holds config templates, and the file simply does not belong in the app at all. - README.md was a three-line internal stub (with a typo in "YunoHost"). Replaced with a real app README following the format their readme_generator emits -- it will be regenerated by their tooling once the repo lives in YunoHost-Apps. doc/ (ADMIN, DESCRIPTION, PRE_INSTALL) stays: that is standard packaging v2, not a leftover. What remains is exactly a YunoHost app: manifest.toml, config_panel.toml, tests.toml, LICENSE, README.md, conf/, scripts/, hooks/, doc/. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| conf | ||
| doc | ||
| hooks | ||
| scripts | ||
| config_panel.toml | ||
| LICENSE | ||
| manifest.toml | ||
| README.md | ||
| tests.toml | ||
ejabberd, packaged for YunoHost
Robust, scalable and extensible realtime platform (XMPP server)
Overview
ejabberd is an XMPP server written in Erlang. This package
integrates it with YunoHost: accounts come from YunoHost's LDAP directory (permission-gated),
certificates are the ones YunoHost already manages, and nginx serves the
.well-known discovery endpoints plus the BOSH and WebSocket entry points.
Out of the box it passes the XMPP Compliance Suites 2023
at 100% — including XEP-0368 direct TLS, XEP-0363 HTTP upload, XEP-0215 external
STUN/TURN discovery and XEP-0485 PubSub server information — and it publishes its own
DNS records, so yunohost domain dns push sets up the _xmpp and _xmpps SRV entries
for you.
Requires YunoHost 13 (Debian 13 / Trixie) or newer. The configuration uses ejabberd 24.12 features that the Bookworm package does not have, so Bookworm is deliberately unsupported.
Cannot be installed alongside another XMPP server (prosody, metronome) — they
compete for ports 5222 and 5269.
Documentation
- Official documentation: https://docs.ejabberd.im/
- Admin notes for this package:
doc/ADMIN.md - Before you install:
doc/PRE_INSTALL.md
📦 Developer info
Pull requests are welcome and should target the testing branch.
The testing branch can be tested using:
# fresh install:
sudo yunohost app install https://github.com/YunoHost-Apps/ejabberd_ynh/tree/testing
# upgrade an existing install:
sudo yunohost app upgrade ejabberd -u https://github.com/YunoHost-Apps/ejabberd_ynh/tree/testing
📚 App packaging documentation
Please see https://doc.yunohost.org/packaging_apps for more information.