Prosody Installation

Introduction

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)

% 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";
    }

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.