Skip to content

Latest commit

 

History

History
48 lines (38 loc) · 1.5 KB

QuickInstallProsody.md

File metadata and controls

48 lines (38 loc) · 1.5 KB
Raw

Quick installation for Prosody

This documentation assumes that you:

  1. already have a working Prosody configuration,
  2. it works with together JSXC, and
  3. you have a simple, single-domain, single-purpose installation.

If you need to start from scratch, look at our step-by-step tutorial. If you have advanced requirements, would like to know background, or run into trouble with this setup, read the full installation instructions.

Software installation

Currently, only nightlies are supported, which you get by

sudo -s
echo deb https://dl.jsxc.org stable main > /etc/apt/sources.list.d/jsxc.list
wget -qO - https://dl.jsxc.org/archive.key | apt-key add -
apt update
apt install xcauth

xcauth configuration

⚠️ The API secret must not fall into the wrong hands! Anyone knowing it can authenticate as any user to the XMPP server (and create arbitrary new users on the XMPP server).

cp xcauth.conf /etc
chown xcauth:xcauth /etc/xcauth.conf
chmod 660 /etc/xcauth.conf

Modify /etc/xcauth.conf according to your environment. The values for API URL and API SECRET can be found in your Nextcloud JSXC admin page.

Adapt Prosody configuration to use xcauth

Add the following to your Prosody config (probably /etc/prosody/prosody.cfg.lua):

authentication = "external"
external_auth_command = "/opt/xmpp-cloud-auth/xcauth.py"
plugin_paths = { "/opt/xmpp-cloud-auth/prosody-modules/" }

Ready!