Difference between revisions of "Prosody"

From SME Server
Jump to navigationJump to search
m (→‎Adding service and open ports: better readability)
Line 16: Line 16:
 
To automatically start Prosody at boot and configure the ports:
 
To automatically start Prosody at boot and configure the ports:
 
  ln -s /etc/rc.d/init.d/e-smith-service /etc/rc7.d/S99prosody
 
  ln -s /etc/rc.d/init.d/e-smith-service /etc/rc7.d/S99prosody
  config set prosody service status enabled access private TCPPort 5222 UDPport 5222 ; signal-event remoteaccess-update
+
  config set prosody service  
 +
config setprop prosody status enabled
 +
config setprop prosody access private
 +
config setprop prosody TCPPort 5222
 +
config setprop prosody UDPport 5222
 
You can toggle the ''access'' property to enable public/private access.
 
You can toggle the ''access'' property to enable public/private access.
 +
 +
 +
 +
Then to activate apply the new service:
 +
signal-event remoteaccess-update
  
 
===Configuration file===
 
===Configuration file===

Revision as of 12:23, 3 February 2015

Warning.png Work in Progress:
This page is a Work in Progress. The contents off this page may be in flux, please have a look at this page history the to see list of changes.


About

"Prosody is a modern XMPP communication server (aka Jabber). It aims to be easy to set up and configure, and efficient with system resources. Additionally, for developers it aims to be easy to extend and give a flexible system on which to rapidly develop added functionality, or prototype new protocols."


Installation

These instructions are for SME Server 9.0 64-bit only.

Prosody is available from the epel repository, so you have to enable the epel repository. Epel only holds the 0.8.x series of Prosody, to install or upgrade to the latest 9.x series of Prosody see below instructions. After enabling the epel repository, prosody can be installed with:

yum install prosody lua-ldap lua-event --enablerepo=epel


Configuration

Adding service and open ports

To automatically start Prosody at boot and configure the ports:

ln -s /etc/rc.d/init.d/e-smith-service /etc/rc7.d/S99prosody
config set prosody service 
config setprop prosody status enabled
config setprop prosody access private
config setprop prosody TCPPort 5222
config setprop prosody UDPport 5222

You can toggle the access property to enable public/private access.


Then to activate apply the new service:

signal-event remoteaccess-update

Configuration file

Prosody's configuration file is located at:

/etc/prosody/prosody.cfg.lua

The basic settings you have to change to run your prosody server on your domain (replace "example.com" with "yourdomain.com"):

admins = {"admin@yourdomain.com"}
allow_registration = true
VirtualHost "localhost"
VirtualHost "yourdomain.com"
enabled = true

You can now start prosody by entering:

service prosody start

Any XMPP client can register itself on your server or you can use LDAP authentication so that your SME Server users automatically have access to your XMPP server.

Register yourself as "admin" to be an administrator as defined in the configuration file.

Modules configuration

TBA


LDAP configuration

TBA


Prosody version 0.9.x

TBA

mkdir -p /root/install/prosody/0.9 ; cd /root/install/prosody/0.9
wget \
http://ftpsrv01.networklab.ca/centos/6/RPMS/x86_64/prosody-0.9.4-2.el6.x86_64.rpm \
http://ftpsrv01.networklab.ca/centos/6/RPMS/x86_64/lua-bitop-1.0.2-1.el6.x86_64.rpm \
http://ftpsrv01.networklab.ca/centos/6/RPMS/x86_64/lua-sec-0.4.1-6.el6.x86_64.rpm \
http://ftpsrv01.networklab.ca/centos/6/RPMS/x86_64/luajit-2.0.2-9.el6.x86_64.rpm \
http://ftpsrv01.networklab.ca/centos/6/RPMS/x86_64/lua-zlib-0.2-1.el6.x86_64.rpm \

yum localinstall *.rpm --enablerepo=epel

Documentation

For further and detailed configuration of the Prosody server and services, please see the Prosody documentation