Public | Automated Build

Last pushed: 3 years ago
Short Description
Short description is empty for this repo.
Full Description


Ejabberd server version 15.04 with SSL and internal auth enabled by default. To control the XMPP server, register an admin user 'admin@\<domain>' with your prefered XMPP client or ejabberdctl. You can change the default domain localhost and other settings through environment variables.

Quickstart example

You can start of with the following container:

docker run -d \
    --name "ejabberd" \
    -p 5222:5222 \
    -p 5269:5269 \
    -p 5280:5280 \
    -h '' \
    -e "" \
    -e "ERLANG_NODE=ejabberd" \
    -e "" \
    -e "TZ=Europe/Berlin" \
docker exec -ti ejabberd ejabberdctl register admin password1234
docker exec -ti ejabberd ejabberdctl register admin2 password12345


Run in background

$ docker run -d -P rroemhild/ejabberd

Run in foreground with attached erlang shell

Set -i and -t option and append live to get an interactive erlang shell:

$ docker run -i -t -P rroemhild/ejabberd live

You can terminate the erlang shell with q()..

Using your own ssl certificates

TLS is enabled by default and the run script will auto-generate two snakeoil certificates during boot if you don't provide your ssl certificates.

To use your own certificates, there are two options.

  1. Mount the volume /opt/ejabberd/ssl to a local directory with the .pem files:
  • /tmp/ssl/host.pem (SERVER_HOSTNAME)
  • /tmp/ssl/xmpp_domain.pem (XMPP_DOMAIN)

Make sure that the certificate and private key are in one .pem file. If one file is missing it will be auto-generated. I.e. you can provide your certificate for your XMMP_DOMAIN and use a snakeoil certificate for the SERVER_HOSTNAME.

  1. Specify the certificates via environment variables: SSLCERT_HOST and SSLCERT_EXAMPLE_COM. For the
    domain certificates, make sure you match the domain names given in XMPP_DOMAIN.

Using docker-ejabberd as base image

The image is called rroemhild/ejabberd and is available on the Docker registry.

FROM rroemhild/ejabberd
ADD ./ejabberd.yml.tpl /opt/ejabberd/conf/ejabberd.yml.tpl
ADD ./ejabberdctl.cfg.tpl /opt/ejabberd/conf/ejabberdctl.cfg.tpl

If you need root privileges switch to USER root and go back to USER ejabberd when you're done.

Environment variables / Runtime configuration

You can additionally provide extra runtime configuration in a downstream image by replacing the config template ejabberd.yml.tpl with one based on this image's template and include extra interpolation of environment variables. The template is parsed by Jinja2 with the runtime environment (equivalent to Python's os.environ available as env).

Additional options

With ERL_OPTIONS you can overwrite additional options passed to erlang while starting ejabberd.

XMPP domain

By default the container will serve the XMPP domain localhost. In order to serve a different domain at runtime, provide the XMPP_DOMAIN variable as such:

$ docker run -d -P -e "" rroemhild/ejabberd

Set admin users

Set one or more admin user (seperated by whitespace) with the EJABBERD_ADMIN environment variable:

$ docker run -d --name ejabberd -P \
    -e "" \
    -e "" \

To automatically register admin users with a random password set the variable EJABBERD_AUTO_RANDPWD to true and check the container logs:

$ docker run -d --name ejabberd -P \
    -e "" \
    -e "" \

$docker logs ejabberd
User successfully registered
Password for user is 7CsnbmMW-9w0Ka06

Or provide the passwords with the EJABBERD_ADMIN_PWD environment variable:

$ docker run -d --name ejabberd -P
    -e "" \
    -e "" \
    -e "EJABBERD_ADMIN_PWD=pass123 pass234" \


By default the loglevel is set to INFO (4). To set another loglevel provide the LOGLEVEL variable as such:

$ docker run -d -P -e "LOGLEVEL=5" rroemhild/ejabberd
loglevel: Verbosity of log files generated by ejabberd.
0: No ejabberd log at all (not recommended)
1: Critical
2: Error
3: Warning
4: Info
5: Debug

Erlang node name

By default the erlang node name is set to ejabberd@localhost. If you want to set the erlang node name to hostname provide the ERLANG_NODE variable such as:

$ docker run -d -P -e "ERLANG_NODE=ejabberd" rroemhild/ejabberd

For more ERLANG_NODE formats see ejabberdctl.cfg.tpl.

Erlang cookie

By default the erlang cookie is generated when ejabberd starts and can't find the .erlang.cookie file in $HOME. To set your own cookie provide the ERLANG_COOKIE variable with your cookie such as:

$ docker run -d -P -e "ERLANG_COOKIE=YOURERLANGCOOKIE" rroemhild/ejabberd

Anonymous auth

Set the AUTH_METHOD variable to enable anonymous:

$ docker run -d -P -e "AUTH_METHOD=anonymous" rroemhild/ejabberd

Run ejabberdctl in container

The ejabberdctl command is in the search path and can be run by:

$ docker exec CONTAINER ejabberdctl help

Register the admin user

$ docker exec CONTAINER ejabberdctl register admin XMPP_DOMAIN PASSWORD

Exposed ports

  • 5222
  • 5269
  • 5280
  • 4560

Exposed volumes

  • /opt/ejabberd/database
  • /opt/ejabberd/ssl
Docker Pull Command
Source Repository