2018-11-19 10:39:54 +01:00
|
|
|
|
2022-05-04 02:36:40 +02:00
|
|
|
<p align="center">
|
|
|
|
<img src="https://www.process-one.net/wp-content/uploads/2022/05/ejabberd-logo-rounded-index.png"
|
|
|
|
height="216">
|
|
|
|
</p>
|
|
|
|
<p align="center">
|
|
|
|
<a href="https://github.com/processone/ejabberd/tags" alt="GitHub tag (latest SemVer)">
|
|
|
|
<img src="https://img.shields.io/github/v/tag/processone/ejabberd?sort=semver&logo=embarcadero&label=&color=3fb0d2&logoWidth=20" /></a>
|
|
|
|
<a href="https://hex.pm/packages/ejabberd" alt="Hex version">
|
|
|
|
<img src="https://img.shields.io/hexpm/v/ejabberd.svg" /></a>
|
|
|
|
<a href="https://github.com/processone/ejabberd/pkgs/container/ejabberd" alt="GitHub Container">
|
|
|
|
<img src="https://img.shields.io/github/v/tag/processone/ejabberd?label=container&sort=semver" /></a>
|
|
|
|
<a href="https://hub.docker.com/r/ejabberd/ecs/" alt="Docker Image Version (latest semver)">
|
|
|
|
<img src="https://img.shields.io/docker/v/ejabberd/ecs?label=docker" /></a>
|
|
|
|
<a href="https://formulae.brew.sh/formula/ejabberd" alt="homebrew version">
|
|
|
|
<img src="https://img.shields.io/homebrew/v/ejabberd" /></a>
|
|
|
|
<br />
|
|
|
|
<a href="https://github.com/processone/ejabberd/actions/workflows/ci.yml" alt="CI">
|
|
|
|
<img src="https://github.com/processone/ejabberd/actions/workflows/ci.yml/badge.svg" /></a>
|
|
|
|
<a href="https://coveralls.io/github/processone/ejabberd?branch=master" alt="Coverage Status">
|
|
|
|
<img src="https://coveralls.io/repos/github/processone/ejabberd/badge.svg?branch=master "Coverage in coveralls.io"" /></a>
|
|
|
|
<a href="https://hosted.weblate.org/projects/ejabberd/ejabberd-po/" alt="Translation status">
|
|
|
|
<img src="https://hosted.weblate.org/widgets/ejabberd/-/ejabberd-po/svg-badge.svg"" /></a>
|
|
|
|
</p>
|
2018-11-19 10:39:54 +01:00
|
|
|
|
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
[ejabberd][im] is an open-source,
|
|
|
|
robust, scalable and extensible realtime platform built using [Erlang/OTP][erlang],
|
|
|
|
that includes [XMPP][xmpp] Server, [MQTT][mqtt] Broker and [SIP][sip] Service.
|
2018-11-19 10:39:54 +01:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
Check the features in [ejabberd.im][im], [ejabberd Docs][features],
|
|
|
|
[ejabberd at ProcessOne][p1home], and a list of [supported protocols and XEPs][xeps].
|
2018-11-19 10:39:54 +01:00
|
|
|
|
2021-07-16 10:10:12 +02:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
Installation
|
|
|
|
------------
|
2021-07-16 10:10:12 +02:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
There are several ways to install ejabberd:
|
2021-07-16 10:10:12 +02:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
- Source code: compile yourself, see [COMPILE](COMPILE.md)
|
|
|
|
- Installers from [ProcessOne Downloads][p1dl] (run/deb/rpm for x64)
|
|
|
|
- Installers from [ejabberd GitHub Releases][releases] (run/deb/rpm for x64 and arm64)
|
|
|
|
- Container image from [ejabberd Docker Hub][hubecs], see [ecs README][docker-ecs-readme] (for x64)
|
|
|
|
- Container image from [ejabberd Github Packages][packages], see [CONTAINER](CONTAINER.md) (for x64 and arm64)
|
|
|
|
- Using your [Operating System package][osp]
|
|
|
|
- Using the [Homebrew][homebrew] package manager
|
2021-07-16 10:10:12 +02:00
|
|
|
|
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
Documentation
|
|
|
|
-------------
|
2021-07-16 10:10:12 +02:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
Please check the [ejabberd Docs][docs] website.
|
2021-07-16 10:10:12 +02:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
When compiling from source code, you can get some help with:
|
2021-07-16 10:10:12 +02:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
./configure --help
|
2021-07-16 10:10:12 +02:00
|
|
|
make help
|
2018-11-19 10:39:54 +01:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
Once ejabberd is installed, try:
|
2018-11-19 10:39:54 +01:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
ejabberdctl help
|
|
|
|
man ejabberd.yml
|
2021-01-12 18:33:27 +01:00
|
|
|
|
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
Development
|
|
|
|
-----------
|
2021-01-12 18:33:27 +01:00
|
|
|
|
2022-04-22 20:32:57 +02:00
|
|
|
Bug reports and features are tracked using [GitHub Issues][issues],
|
|
|
|
please check [CONTRIBUTING](CONTRIBUTING.md) for details.
|
|
|
|
|
|
|
|
Translations can be improved online [using Weblate][weblate]
|
|
|
|
or in your local machine as explained in [Localization][localization].
|
|
|
|
|
|
|
|
Documentation for developers is available in [ejabberd docs: Developers][docs-dev].
|
|
|
|
|
|
|
|
Security reports or concerns should preferably be reported privately,
|
|
|
|
please send an email to the address: contact [at] process-one [dot] net
|
|
|
|
or some other method from [ProcessOne Contact][p1contact].
|
|
|
|
|
2022-05-04 02:36:40 +02:00
|
|
|
For commercial offering and support, including [ejabberd Business Edition][p1home]
|
|
|
|
and [Fluux (ejabberd in the Cloud)][fluux], please check [ProcessOne ejabberd page][p1home].
|
2022-04-22 20:32:57 +02:00
|
|
|
|
|
|
|
|
|
|
|
Community
|
|
|
|
---------
|
|
|
|
|
|
|
|
There are several places to get in touch with other ejabberd developers and administrators:
|
|
|
|
|
|
|
|
- [ejabberd XMPP chatroom][muc]: ejabberd@conference.process-one.net
|
|
|
|
- [Mailing list][list]
|
|
|
|
- [GitHub Discussions][discussions]
|
|
|
|
- [Stack Overflow][stackoverflow]
|
|
|
|
|
|
|
|
|
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
|
|
|
ejabberd is released under the GNU General Public License v2 (see [COPYING](COPYING.md)),
|
|
|
|
and [ejabberd translations](https://github.com/processone/ejabberd-po/) under MIT License.
|
|
|
|
|
|
|
|
|
|
|
|
[discussions]: https://github.com/processone/ejabberd/discussions
|
|
|
|
[docker-ecs-readme]: https://github.com/processone/docker-ejabberd/tree/master/ecs#readme
|
|
|
|
[docs-dev]: https://docs.ejabberd.im/developer/
|
|
|
|
[docs]: https://docs.ejabberd.im
|
|
|
|
[erlang]: https://www.erlang.org/
|
|
|
|
[features]: https://docs.ejabberd.im/admin/introduction/
|
2022-05-04 02:36:40 +02:00
|
|
|
[fluux]: https://fluux.io/
|
2022-04-22 20:32:57 +02:00
|
|
|
[github]: https://github.com/processone/ejabberd
|
|
|
|
[homebrew]: https://docs.ejabberd.im/admin/installation/#homebrew
|
|
|
|
[hubecs]: https://hub.docker.com/r/ejabberd/ecs/
|
|
|
|
[im]: https://ejabberd.im/
|
|
|
|
[issues]: https://github.com/processone/ejabberd/issues
|
|
|
|
[list]: https://lists.jabber.ru/mailman/listinfo/ejabberd
|
|
|
|
[localization]: https://docs.ejabberd.im/developer/extending-ejabberd/localization/
|
|
|
|
[mqtt]: https://mqtt.org/
|
|
|
|
[muc]: xmpp:ejabberd@conference.process-one.net
|
|
|
|
[osp]: https://docs.ejabberd.im/admin/installation/#operating-system-packages
|
|
|
|
[p1contact]: https://www.process-one.net/en/company/contact/
|
|
|
|
[p1dl]: https://www.process-one.net/en/ejabberd/downloads/
|
|
|
|
[p1home]: https://www.process-one.net/en/ejabberd/
|
|
|
|
[packages]: https://github.com/processone/ejabberd/pkgs/container/ejabberd
|
|
|
|
[releases]: https://github.com/processone/ejabberd/releases
|
|
|
|
[sip]: https://en.wikipedia.org/wiki/Session_Initiation_Protocol
|
|
|
|
[stackoverflow]: https://stackoverflow.com/questions/tagged/ejabberd?sort=newest
|
|
|
|
[weblate]: https://hosted.weblate.org/projects/ejabberd/ejabberd-po/
|
|
|
|
[xeps]: https://www.process-one.net/en/ejabberd/protocols/
|
|
|
|
[xmpp]: https://xmpp.org/
|