Ansible role that deploys, maintains, and updates Prosody - XMPP Server written in Lua.
Go to file
meaz 10ae1db100 Merge pull request 'add muc_reserve_nick_pattern' (#28) from muc_reserve_nick_pattern into main
Reviewed-on: #28
Reviewed-by: muppeth <muppeth@no-reply@disroot.org>
2023-05-16 19:16:21 +00:00
Playbooks Change from mod_http_upload to mod_http_file_share (#19) 2022-02-26 20:58:49 +00:00
defaults add muc_reserve_nick_pattern 2023-05-06 10:42:34 +02:00
handlers Migration commit; fresh start 2021-03-14 11:00:16 +01:00
tasks change include to include_tasks 2023-01-09 07:08:50 +01:00
templates/etc changed default port for s2s direct tls; added interfaces variable to be able to define on which interfaces prosody should listen on 2023-02-18 05:59:13 +01:00
.gitignore Migration commit; fresh start 2021-03-14 11:00:16 +01:00
CHANGELOG.md Change from mod_http_upload to mod_http_file_share (#19) 2022-02-26 20:58:49 +00:00
DNS_configuration.md Migration commit; fresh start 2021-03-14 11:00:16 +01:00
LICENSE Migration commit; fresh start 2021-03-14 11:00:16 +01:00
README.MD Migration commit; fresh start 2021-03-14 11:00:16 +01:00
Vagrantfile add acl in vagrant file 2023-01-09 07:08:44 +01:00

README.MD

Prosody - Ansible Role

This role deploys prosody XMPP server with all needed dependencies and prosody community modules.

You can deploy a test instance using Vagrantfile attached to the role. This role is released under MIT Licence. We do not give no warranty for this software.

Run in production

To run this role in production, do not forget to set your DNS as explained here and to change all vars from files in default/ to what you need.

The role's defaults should be already dpeloying fully funcitonal and modern XMPP Server. It allows to add/remove any additional module (whether core or community).

Run test in Vagrant

To have it work using vagrant:

  • cd prosody where prosodyis the name of this repo.
  • vagrant up to build up the Virtual Environment.
  • and ansible-playbook -b Playbooks/prosody.yml to deploy Prosody on the Virtual Environment.

Setup turnserver for viop

If you want to use viop, you need to set turncredentials to true in default/mod.yml. This feature depends on a third party service that needs to be installed seperatelly: coturn. To see how to set it, check Prosody's documentation

Add LDAP authentication and vhosts

To add LDAP authentication, edit defaults/vhost.yml, change auth_method from internal_hashed to ldap and change the LDAP vars in prosody_ldap_config.

This role supports multiple vhosts.