Install ejabberd

Submitted by badlop on Tue, 2004-10-26 07:30

In the Tutorials page there are links to other tutorials about installing and configuring ejabberd.

Install Erlang

from source

Install Libncurses development files
- with Debian APT
```
apt-get install libncurses5-dev
```
Install OpenSSL and its development files
- with Debian APT
```
apt-get install openssl libssl-dev
```

Install Erlang

Download Erlang/OTP source code and uncompress it. For example:

wget http://www.erlang.org/download/otp_src_R11B-5.tar.gz
tar -xzvf otp_src_R11B-5.tar.gz
cd otp_src_R11B-5
LANG=C; export LANG

Compile and install it:

./configure
make
make install

with Debian APT
```
apt-get install erlang
```

using Port Collection on FreeBSD

cd /usr/ports/lang/erlang-lite && make all install clean

Verify Installation

Check if it is correctly installed:

erl
Erlang (BEAM) emulator version 5.5.5 [source] [hipe]


Eshell V5.5.5  (abort with ^G)
1> halt().

Install ejabberd
- from source SVN
  1. Install Libexpatl development files
    - with Debian APT
```
apt-get install libexpat1-dev
```
  2. Retrieve ejabberd from the Subversion repository
```
svn co http://svn.process-one.net/ejabberd/trunk ejabberd
```
  3. Compile
```
cd ejabberd/src
./configure
make
```
  4. Configure
    
    You can use the example configuration file:
```
cp ejabberd.cfg.example ejabberd.cfg
```
    You should add a user to your system:
```
addgroup jabber
adduser ejabberd
adduser ejabberd jabber
chown ejabberd:jabber ../src -R
chmod 750 ../src -R
```
  5. Execute
    
    Command to execute ejabberd:
```
su ejabberd -c "erl -s ejabberd -name ejabberd 
                               -ejabberd config '\"ejabberd.cfg\"' -detached"
```
    You can use a script.
- using apt on Debian unstable and testing
  
  It is as easy as:
```
apt-get install ejabberd
```
- using apt on Debian stable
  
  Add Teopetuk's unofficial Debian APT repository if you do not have it. Then update the list of available packages and finally install it:
```
apt-get install ejabberd
```
- using Port Collection on FreeBSD
```
cd /usr/ports/net-im/ejabberd && make all install clean
```

Enable SSL/TLS Secured Communication

Create a SSL key (read this tutorial for more information):

openssl req -new -x509 -newkey rsa:1024 -days 3650 -keyout privkey.pem -out server.pem
openssl rsa -in privkey.pem -out privkey.pem
cat privkey.pem >> server.pem
rm privkey.pem

Now edit your ejabberd.cfg file and specify the correct location of your server.pem:

{listen, [{5222, ejabberd_c2s,     [{access, c2s}, {shaper, c2s_shaper},
                                    starttls, {certfile, "/home/ejabberd/server.pem"}]},
          {5223, ejabberd_c2s,     [{access, c2s}, {shaper, c2s_shaper},
                                    tls, {certfile, "/home/ejabberd/server.pem"}]},
          ...
]}.

{s2s_use_starttls, true}.
{s2s_certfile, "/home/ejabberd/server.pem"}.