Ansible role that deploys, maintains, and updates Prosody - XMPP Server written in Lua.
Go to file
meaz 74239698b6
Merge branch 'master' into cdomain
2022-12-29 10:04:52 +01:00
Playbooks Change from mod_http_upload to mod_http_file_share (#19) 2022-02-26 20:58:49 +00:00
defaults Merge branch 'master' into cdomain 2022-12-29 10:04:52 +01:00
handlers added direct tls port option and small addition for custom domain stuff 2022-01-06 22:10:46 +01:00
tasks Merge branch 'master' into cdomain 2022-12-29 10:04:52 +01:00
templates/etc Merge branch 'master' into cdomain 2022-12-29 10:04:52 +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 Better match with latest developpement (#24) 2022-09-06 19:37:21 +00: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.