Creating accounts

The first thing you will normally want to do after installing Prosody is to create yourself (and possibly others) accounts, or allow them to create accounts.

In-band registration in Jabber is a way for clients to ask the server to create an account. Obviously enabling such a protocol on the open internet can lead your server open to abuse, so in the default configuration registration is disabled.

To allow registration for a host, make sure mod_register is loaded (that you have “register” in modules_enabled) and add this line:

  allow_registration = true

It is possible to secure account registration a bit by restricting it to particular IP addresses, or limiting how often an IP address can register an account. These options are described on our configuration page.

On all platforms except for Windows (currently) Prosody has a command-line utility called prosodyctl. This can be used to add a user account like so:

 prosodyctl adduser me@example.com

Prosody will then prompt you for a password, and you will be able to log into your account using your client.

For batch registration of accounts consider the 'prosodyctl register' command, which allows you to specify everything on one line:

 prosodyctl register me example.com mypassword

Prosody has a tools to convert ejabberd database dumps to Prosody's own data format. These tools currently aren't supplied with any packages (we're working on it) but if you have the Prosody source package then you can do the following:

./tools/ejabberd2prosody.lua ejabberd_dump.txt

…where ejabberd_dump.txt is a file created with the 'ejabberdctl dump' command supplied by ejabberd.

If you're using ejabberd with a MySQL backend, you may use ejabberdsql2prosody in the following way

./tools/ejabberdsql2prosody.lua filename.sql hostname

…where filename.sql is a MySQL dump created by e.g. “mysqldump db_name > filename.sql”