Skip to content

The ejabberd Developer Livebook


This page is designed to run interactively using Livebook. Of course, you could simply reproduce the instructions manually yourself. But, if possible, install Livebook in your machine and get the full experience clicking on the button:

Run in Livebook

filename = "ejabberd.yml"

if File.exists?(filename) do
    {:ejabberd, "~> 24.2"},
    {:kino, "~> 0.12.3"}
  url = ""

  Mix.install([:req]) &&
      String.replace(Req.get!(url).body, "starttls_required: true", "")

  IO.puts("ejabberd.yml downloaded correctly, click 'Reconnect and setup' to download ejabberd.")

Setup ejabberd inside livebook

This Livebook will download, compile and install ejabberd:

  1. If you want to use a specific ejabberd.yml configuration file, copy it to your Livebook folder.

  2. On top of this page, click Setup.

  3. If ejabberd.yml is not found, it will be downloaded from ejabberd git repository.

  4. Click Reconnect and setup to download ejabberd and all its dependencies. It will be compiled and started... it may take a pair of minutes.

Alternatively, if you already have ejabberd installed and running in your system, you can connect livebook to your ejabberd node

Execute some Erlang code

Now that Livebook is connected a running ejabberd node, you can run Erlang and Elixir code from this page directly in your node.

For example, to run some erlang code, put your mouse over the new lines and click on Evaluate:


Let's define the details of an account, we will later register it. You may change those values:

Username = <<"user1">>,
Server = <<"localhost">>,
Password = <<"somepass123">>,
{Username, Server, Password}.

Now let's execute an Erlang function to register the account:

ejabberd_auth:try_register(Username, Server, Password).

Let's check the account was registered:


And is the account's password the one we introduced?

Password == ejabberd_auth:get_password(Username, Server).

Ok, enough for now, let's remove the account:

ejabberd_auth:remove_user(Username, Server).

Execute some Elixir code

The same code of the previous section can be executed using Elixir:

username = <<"user1">>
server = <<"localhost">>
password = <<"somepass123">>
{username, server, password}
:ejabberd_auth.try_register(username, server, password)
password == :ejabberd_auth.get_password(username, server)
:ejabberd_auth.remove_user(username, server)

Run API commands

Let's run some ejabberd API commands using the ejabberd_ctl frontend (there is is also mod_http_api and ejabberd_xmlrpc).

For example, the status API command:


How to register an account using ejabberd_ctl to call the API command

command = ~c"register"
:ejabberd_ctl.process([command, username, server, password])

If you have ejabberd installed in the the system, and the ejabberdctl command-line script is available in your PATH, then you could also try to execute with:

os:cmd("ejabberdctl status").
:os.cmd(~c"ejabberdctl status")

Draw process structure

Let's view the ejabberd process tree:

Kino.Process.render_app_tree(:ejabberd, direction: :left_right)

Let's view the erlang processes that handle XMPP client connections. If this graph is empty, login to ejabberd with a client and reevaluate this code:

Kino.Process.render_sup_tree(:ejabberd_c2s_sup, direction: :left_right)

And some information about the erlang process that handles the XMPP client session:

[resource] = :ejabberd_sm.get_user_resources(username, server), server, resource))

Connect Livebook to your ejabberd node

By default this livebook downloads, compiles and starts ejabberd by setting up ejabberd sinde livebook. If you already have ejabberd installed and would like to connect this livebook to your existing ejabberd node, follow those steps:

Get erlang node name

To connect Livebook to your running ejabberd node, you must know its erlang node name and its cookie.

The erlang node name is by default ejabberd@localhost. You can check this in many places, for example:

  • Using ejabberdctl status:
$ ejabberdctl status
The node ejabberd@localhost is started with status: started
ejabberd 24.2.52 is running in that node
  • In the ejabberd.log file, which contains a line like:
2024-03-26 13:18:35.019288+01:00 [info] <0.216.0>@ejabberd_app:start/2:63
ejabberd 24.2.52 is started in the node ejabberd@localhost in 0.91s

Setup ejabberd node

A Livebook can only connect to an Erlang node that has Elixir support. So, make sure you install not only Erlang, but also Elixir.

When compiling ejabberd, make sure to enable Elixir support. It should get enabled by default, but you can ensure this: either by ./configure --with-rebar=mix or by ./configure --enable-elixir.

Then start ejabberd with IEx shell: ejabberdctl iexlive

The erlang cookie is a random string of capital letters required to connect to an existing erlang node.

You can get it in a running node, simply call:


Connect this livebook to your ejabberd node

Now that you have ejabberd running, and you know the information required to connect to it:

  1. go to Livebook
  2. in the left side bar, click the Runtime settings icon, or press sr keyboard shortcut
  3. click the Configure button
  4. click the Attached node button
  5. introduce the erlang node name (ejabberd@localhost) and cookie (XQFOPGGPSNEZNUWKRZJU) of your ejabberd node
  6. click the Connect button (it may say Reconnect)
  7. If it connected successfully, it will now show memory consumption of that node

Test the connection

Now that Livebook is connected to your running ejabberd node, you can run Erlang and Elixir code from this page directly in your node.

For example, to run some erlang code, put your mouse over the new lines and click on Evaluate:


The same code can be executed using Elixir:


Stop ejabberd

Let' stop ejabberd insie livebook