Configure ejabberd

After you have installed ejabberd, you need to configure it. There is a file called ejabberd.cfg.example in the distribution; copy it to ejabberd.cfg and start editing it. The most important things to do are to set your hostname and set up admin users; that's enough to get your server running.

These things are explained more thoroughly in the ejabberd installation and operation guide; this document is intended as a gentle introduction.

Set your hostname

Find the line that says {hosts, ["localhost"]}. and change localhost to the hostname you want your Jabber server to use. This is what appears behind the @ sign in Jabber IDs; it's not necessarily the physical hostname of the machine.

Set up admin users

Add one or several lines of the form {acl, admin, {user, "username", "example.com"}}. in the configuration. This means that the user username@example.com can configure the server in various ways through a Jabber client or through the web interface.

Note: In the default configuration, account registration is free. This means that someone could register this account just after you start the server, and thus become server administrator. If you are worried about that, do the following step, stop the server, and then do this step.

Create admin users

Now, start the server (see the guide, section "Starting"). Use a Jabber client to register the accounts you designated as admins in the previous step. Choose a good password.

Try web admin interface

Point a web browser to http://example.com:5280/admin/ (replace example.com with the hostname or IP address of your Jabber server; that would be localhost if you are using the computer directly). You will be asked for a username and password. Enter your full JID, e.g. yourname@example.com, and your password. You should now be logged in to the web admin interface.

Syndicate content