gistfile1.md

Archipel needs ejabberd as XMPP server (only ejabberd supports sufficiently XMPP protocol for the needs of Archipel).

Here are the steps to sucessfully install Ejabberd to running on most of linux distribuition.

For more detail about architeture and concepts read this page.

Install ejabberd

To be distro agnostic will use the binary installer provided by Process One

Starting from 15.03, you don't need to recompile needed modules your self and there are great improvments such as websockets.

Steps to install:

• Grabb the binary according to your platform.
• Create a user to run ejabberd as non privilegied user (useradd -d /opt/ejabberd ejabberd)
• Install the binary as the ejabberd user (`sudo -u ejabberd /tmp/ejabberd-15.03-linux-x86_64-installer.run --mode unattended --adminpw admin --prefix /opt/ejabberd/)

You are done you have a working installation of ejabberd.

Starting ejabberd

In /opt/ejabberd/bin directory you will find;

• ejabberd.service for systemd
• ejabberd.init for init.d

Choose the one you want to use according to your distro or just ran /opt/ejabberd/bin/ejabberdctl start to start it right now.

Installing modules

Note*: In ejabberd 15.04, the module mod_admin_extra will be included with default ejabberd modules. No need to install it anymore :)

Here is the easy part (no need to compile everything anymore!)

Important Note: ejabberd MUST be started before running the following commands. (see above)

ejabberdctl modules_update_specs
ejabberdctl module_install mod_admin_extra

Done! Or almost... with 15.03 there is bug and the module is not deployed the correct folder.

If /opt/ejabberd/lib/ejabberd-15.03/ebin/mod_admin_extra.beam is not present, copy it from /opt/ejabberd/ejabberd-modules/mod_admin_extra/ebin/mod_admin_extra.beam to /opt/ejabberd/lib/ejabberd-15.03/ebin/

Configuration

When you are done, please continue to ejabberd configuration:

• [[Continue Ejabberd configuration|Ejabberd: Configuration]]