Home

The net/prosody port

prosody-0.12.4p1 – communications server for Jabber/XMPP written in Lua (cvsweb github mirror)

Description

Prosody is a flexible communications server for Jabber/XMPP written in
Lua.  It aims to be easy to use, and light on resources.  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.
WWW: https://prosody.im/

Readme

+-----------------------------------------------------------------------
| Running ${PKGSTEM} on OpenBSD
+-----------------------------------------------------------------------

Using Prosody in an OpenBSD environment

1) Prosody documentation is available online at:

   https://prosody.im/doc/configure

   Use this information to edit:

   ${SYSCONFDIR}/prosody/prosody.cfg.lua

   to your liking.

2) In order to allow for secured connections, SSL certificates need to
   be generated. A Makefile is located in ${SYSCONFDIR}/prosody/certs/.
   Please note that if you wish to use this file, the 'gmake' package
   needs to be installed.

3) Prosody includes an rc script for starting and stopping. You can
   start it by running:

   # ${RCDIR}/prosody start

   You can have it start automatically on boot by adding 'prosody' to your
   pkg_scripts line in /etc/rc.conf.local

4) Prosody comes with prosodyctl script for controlling the daemon. Run
   it without parameters to get list of commands:

   # ${TRUEPREFIX}/sbin/prosodyctl

   For example, to add users you would use something like:

   # ${TRUEPREFIX}/sbin/prosodyctl adduser username@domain.tld

5) In case you decide to enable 'mod_storage_sql', the default SQLite3
   driver has already been installed. If you like to use MySQL/MariaDB or
   PostgreSQL for the database, please install luadbi-mysql or luadbi-pgsql
   respectively.

   For MySQL/MariaDB, also add the following to /etc/login.conf:

   prosody:setenv=LD_PRELOAD=/usr/lib/libpthread.so:tc=daemon:

6) It's possible to copy and convert storage backends with:

   # ${TRUEPREFIX}/sbin/prosody-migrator

   The online documentation can be found at:

   https://prosody.im/doc/migrator

Maintainer

Lucas Gabriel Vuotto

Categories

lang/lua net

Library dependencies

Build dependencies

Run dependencies

Test dependencies

Files

Search