Ejabberd server version 14.12 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.

$ docker run -d -P rroemhild/ejabberd

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()..

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 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.

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 ./ejabberd.yml.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.

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).

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

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 "XMPP_DOMAIN=foo.com" rroemhild/ejabberd

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

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.

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

Set the AUTH_METHOD variable to enable anonymous:

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

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

$ docker exec CONTAINER ejabberdctl help

$ docker exec CONTAINER ejabberdctl register admin XMPP_DOMAIN PASSWORD

• 5222
• 5269
• 5280
• 4560

• /opt/ejabberd/database
• /opt/ejabberd/ssl