Page History

...

Prosody is a lightweight XMPP server, written in lua. It's available from http://prosody.im.

Details

Prosody is now included in most distributions package repositories, so doesn't require manual installation anymore.Install the packages (Ubuntu/Debian)linux distributions. For debian-based distros, run:

%$ sudo -s
# aptitude install prosody

To configure Prosody under GNU/Linux you should find the config in /etc/prosody/prosody.cfg.lua. On other systems, or when not installed, it will be under the same directory as the prosody main executable. See also the Prosody configuration page.

We will configure this for acmewave.com, component port 5275, component secret 'sekritpassword' with the server-to-server port (as set by your SRV record) to 5269.

At the top of the file in the 'Server-wide settings' section add

...

    component_ports = { 5275 }
    s2s_ports = { 5269 }

At the bottom of the file in the 'Components' section add

...

Component "wave.acmewave.com"
    component_secret = "sekritpassword"

Just above that is a section titled 'Virtual hosts'. Change it to look like this:

...

VirtualHost "acmewave.com"
    enabled = true
    ssl = {
        key = "/etc/prosody/certs/wave.acmewave.com.key";
        certificate = "/etc/prosody/certs/wave.acmewave.com.crt";
    }

it, you may use the Prosody configuration tool provided with WaveInABox:

$ ant -f server-config.xml server-federation-config prosody-config -Dxmpp_server_secret=secret_password -Dxmpp_server_ping=example.com -Dxmpp_server_ip=localhost

That will generate a prosody configuration file named something like: example.com.cfg.lua. Copy it wherever Prosody can find it usually /etc/prosody/conf.d and restart the Prosody server:

$ sudo cp example.com.fg.lua /etc/prosody/conf.d/
$ sudo service prosody restart

You can now continue with

The SSL section is only if you have keys for your server, you can remove it otherwise. (But note that federation will need SSL)

Put the cert files in the location you specified in the file.

Test your configuration with luac -p /etc/prosody.cfg.lua (this looks for syntax errors, see the top of the file for more on lua syntax, or read a book.

Reload the configuration and you're done.

# service prosody restart

Now continue following the instructions for installing and running the server.