xmpp-wizard/README.md
2023-11-13 12:31:41 +00:00

1.3 KiB

XMPP server setup script

A priest aiming a gun at the Discord logo

An XMPP server is hecking hard to configure!! But not any more.

You too, can be an XMPP server operator, through the use of this simple script! No scouring over documentation for hours or headache required ;)

However, celibacy is required, since this script is written for use on Arch Linux* only.

Features

  • Modern TLS configuration by default
  • Uses MariaDB as the SQL database
  • Adds an admin account

Modules configured

  • HTTP uploads (XEP-0363)
  • HTTP upload quotas (by total size)
  • STUN/TURN server

Installation

Prerequisites

Make sure you have the following packages installed:

Nginx
MariaDB

Installs

This script installs the following packages:

  • ejabberd - XMPP server
  • certbot - managing certificates

Running

The script should be run as root.

doas/sudo bash xmpp-wizard.sh

To do

mod_http_upload_quota

Allow for toggling of this module and configuring of max_days in script

Disclaimers

Much of the inspiration for this project, along with some of the logic (particularly the certificate detection) was taken from Luke Smith's emailwiz script.

Notes

*fedora and cringe atheistic world view not included