sunx/ejabberd repository overview

⁠Ejabberd XMPP Server Docker image

Docker image with Ejabberd XMPP Server⁠.

⁠Supported tags and respective Dockerfile links

• 17.04⁠, latest⁠ - ejabberd v17.04 - Latest stable version.
• 16.12-beta1⁠, beta⁠ - Latest available beta version.

Dockerfiles for older versions of Seafile Server you can find there⁠.

⁠Quickstart

To run container you can use following command:

docker run \  
  -v /home/docker/ejabberd:/home/ejabberd \  
  -p 5222:5222 -p 5223:5223 -p 5269:5269 \  
  -d sunx/ejabberd

After first run container will create default configuration files for ejabberd in /home/ejabberd/etc/ejabberd/ directory, which you should edit manually. Default configuration file is well documented, so you shouldn't have any problems in changeing it. Also you can read official manual⁠ for help.

⁠Detailed description of image and containers

⁠Used ports

This image uses (at least) 3 tcp ports:

• 5222 - XMPP client connection
• 5223 - XMPP client connection over SSL (you can disable it if you don't plan to use it)
• 5269 - XMPP server connection

⁠Volume

This image uses one volume with internal path /home/ejabberd, it will store configuration files, databases and ejabberd logs.

I would recommend you use host directory mapping of named volume to run containers, so you will not lose your valuable data after image update and starting new container.

⁠ejabberd configuration

For ejabberd configuration you can read official ejabberd documentation⁠, but there are some useful tips:

• Most of ejabberd configuration\administration could be done via ejabberdctl utility. call it without arguments for help (for example, you can use docker exec -ti <container_name> ejabberdctl for it).
• You can find some useful ejabberd plugins in ejabberd-contrib⁠. Installation procedure is described there as well.
• Ejabberd have feature of web-based administration. If you want to use so, then you should turn on it in ejabberd configuration file and public needed port.

⁠License

This Dockerfile and scripts are released under MIT License⁠.

ejabberd⁠ has its own license.