+-----------------------------------------------------------------------
| Running prosody 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:

   /etc/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 /etc/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:

   # /etc/rc.d/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:

   # /usr/local/sbin/prosodyctl

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

   # /usr/local/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:

   # /usr/local/sbin/prosody-migrator

   The online documentation can be found at:

   https://prosody.im/doc/migrator
