After you have 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
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
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.