Go to file
Badlop 7248ee1dbc Fix some typos in the Guide 2011-05-31 21:13:20 +02:00
contrib Move the extract_translations code to the tools dir (EJAB-1311) 2010-09-27 13:39:15 +02:00
doc Fix some typos in the Guide 2011-05-31 21:13:20 +02:00
src Pubsub node maxitem forced to 0 if non persistent node (thanks to Karim Gemayel)(EJAB-1434) 2011-05-31 16:09:27 +02:00
tools Update example extauth script with tryregister, removeuser and removeuser3 (EJAB-641) 2010-12-03 17:23:55 +01:00
.gitignore Ignore OS X libraries. 2010-12-15 16:47:46 +01:00
COPYING * src/msgs/nl.msg: Updated (thanks to Sander Devrieze) 2004-10-09 20:15:49 +00:00
README Update version numbers of the related: exmpp, ejabberd 2, and Erlang 2011-03-11 10:55:34 +01:00

README

ejabberd - High-Performance Enterprise Instant Messaging Server 

Quickstart guide


0. Requirements

To compile ejabberd you need:
 - GNU Make
 - GCC
 - Erlang/OTP R12B-5 or higher. Recommended: R12B-5, R13B04 and R14B01.
   Avoid R14A and R14B.
 - exmpp 0.9.6 or higher
 - OpenSSL 0.9.8 or higher, for STARTTLS, SASL and SSL encryption.
 - Zlib 1.2.3 or higher, for Stream Compression support
   (XEP-0138). Optional.
 - Erlang mysql library. Optional. MySQL authentication/storage.
 - Erlang pgsql library. Optional. PostgreSQL authentication/storage.
 - PAM library. Optional. For Pluggable Authentication Modules (PAM).
 - ESASL library. Optional. For SASL GSSAPI authentication.
 - ImageMagick's Convert program. Optional. For CAPTCHA challenges.


1. Compile and install on *nix systems

To compile ejabberd, go to the directory src/ and execute the commands:
  ./configure
  make

If you get an error like:
  ./configure: No such file or directory
the solution is to first execute:
  aclocal
  autoconf

To install ejabberd, run this command with system administrator rights
(root user):

  sudo make install

These commands will:
 - Install the configuration files in /etc/ejabberd/
 - Install ejabberd binary, header and runtime files in /lib/ejabberd/
 - Install the administration script: /sbin/ejabberdctl
 - Install ejabberd documentation in /share/doc/ejabberd/
 - Create a spool directory: /var/lib/ejabberd/
 - Create a directory for log files: /var/log/ejabberd/


2. Start ejabberd

You can use the ejabberdctl command line administration script to
start and stop ejabberd. For example:
  ejabberdctl start


For detailed information please refer to the
ejabberd Installation and Operation Guide