Difference between revisions of "Prosody"

From SME Server
Jump to navigationJump to search
Line 1: Line 1:
 
==About==
 
==About==
"[http://prosody.im '''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.''
+
"[http://prosody.im '''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==
 
==Installation==
These instructions are for SME Server 9.0 only.
+
These instructions are for SME Server '''9.0''' only.
  
 
Prosody is available from the [[epel|'''epel''']] repository, so you have to enable the [[epel|'''epel''']] repository.
 
Prosody is available from the [[epel|'''epel''']] repository, so you have to enable the [[epel|'''epel''']] repository.

Revision as of 15:23, 26 January 2015

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 only.

Prosody is available from the epel repository, so you have to enable the epel repository. After enabling the epel repository, prosody can be installed with:

yum install prosody lua-ldap --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 access private TCPPort 5222 UDPport 5222
signal-event remoteaccess-update

You can togle the access property to enable public access.

Configuration file

Prosody's configuration file is located at:

/etc/prosody/prosody.cfg.lua

The basic setting 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.


Documentation

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


LDAP configuration

TBA