README.md 1.5 KB
Newer Older
Bernhard Geier's avatar
Doku  
Bernhard Geier committed
1
2
# Ansible: Install a XMPP server on openSUSE Leap

Citronalco's avatar
Citronalco committed
3
This playbook installs a complete XMPP server for one to many domains.\
4
As of August 2021 you will get 100% compliance in Conversations.im compliance test and an "A" score on xmpp.net.
Citronalco's avatar
Citronalco committed
5

Bernhard Geier's avatar
Bernhard Geier committed
6
Tested on openSUSE Leap 15.2 and 15.3.
Bernhard Geier's avatar
Bernhard Geier committed
7

Bernhard Geier's avatar
Doku  
Bernhard Geier committed
8
9
10
11
12
13
14
15
Included are:
* Prosody
* PostgreSQL
* Coturn
* Apache2
* Converse.js with OMEMO support
* LetsEncrypt certificates

Citronalco's avatar
Citronalco committed
16
Supports multiple domains, internal user authentication and authentication against an IMAP server.
Bernhard Geier's avatar
Bernhard Geier committed
17

Citronalco's avatar
Citronalco committed
18
19
### Documentation:
See the example configuration in `host_vars/xmpp.example.com` \
Bernhard Geier's avatar
Bernhard Geier committed
20
21
22
23
24
25
26
The configuration for `host_vars/xmpp.bytewerk.org` is used for a productive server.


### Requirements:
* Server running openSUSE Leap 15.2 or 15.3 with a fixed IPv4 address
* A domain name, and you are able to edit its nameserver entries

Citronalco's avatar
Citronalco committed
27

Citronalco's avatar
Citronalco committed
28
### Usage:
Citronalco's avatar
Citronalco committed
29
30
1. Install Ansible on your machine (e.g. on Suse: `zypper install ansible`, on Debian/Ubuntu/Mint: `apt-get install ansible`)\
Ansible >= 2.10 is required.
Citronalco's avatar
Citronalco committed
31
32
33
34
1. Make sure you can log in on the server as root, without having to type in a password. (Use SSH Public Key authentication.)
1. Rename the file `hosts.example` to `hosts`, edit it and set your server's hostname and IP address
1. In directory `host_vars` rename the file `xmpp.example.com` to your server's hostname and set your preferences in that file
1. Execute `ansible-playbook -i hosts xmpp.yml` to start the installation.\
Citronalco's avatar
Citronalco committed
35
You can use the option  `--diff` to see in detail what Ansible does on your server, and/or `--check` for a dry-run.