Run multiple Openfire servers & DBs in Docker for local testing Federation or Cluster configurations/management
Go to file
Matthew Vivian 49fb6b7f74
chore: Update java.security with new from Openfire
This file has been updated in Openfire to enable CRL downloading, so I'm porting it into this project as we use a copy of the security directory and overwrite the original.
2024-12-03 09:31:00 +00:00
_common Add dependency check for docker & compose 2022-07-27 14:47:41 +02:00
cluster Set to TRACE logging by default (other envs) 2024-11-21 14:09:03 +01:00
cluster_with_federation Set to TRACE logging by default (other envs) 2024-11-21 14:09:03 +01:00
federation chore: Update java.security with new from Openfire 2024-12-03 09:31:00 +00:00
proxy Set to TRACE logging by default (other envs) 2024-11-21 14:09:03 +01:00
scripts Add script to prune _data directories with sudo 2022-07-27 14:47:41 +02:00
simple Set to TRACE logging by default (other envs) 2024-11-21 14:09:03 +01:00
.gitignore Update scripts to ignore fixed name formats 2021-12-20 11:28:33 +00:00
README.md Fix READMEs 2022-07-27 14:47:41 +02:00
stop.sh Drop use of old style "docker-compose" in favour "docker compose" everywhere 2022-07-27 14:47:41 +02:00

README.md

Multiple Openfires in Docker

Quickly create multiple Openfire servers with associated PostgreSQL DBs in Docker containers for local testing.

Data and config snapshots have been taken of each DB and Openfire server so that a known desired state is configured on start. See the "How it's built" section below if you want to understand how this was done or need to add more nodes.

Prerequisites

Quick Start

  1. Make sure you have docker and docker-compose installed
  2. Create a local Openfire docker image, tagged openfire:latest that contains the version of Openfire that you want to run
    1. run docker build --tag openfire:latest . in the root of the Openfire repository (https://github.com/igniterealtime/Openfire)
  3. Launch the environment using the start.sh in the directory of your choice.

How it's built

To recreate the known good state for the system we first create base Openfire and relevant database containers. We then perform the manual setup and any other configuration that we require, such as adding users and MUC rooms. Once the setup is complete we dump the database from the container to the Docker host and copy the Openfire config files from the container to the Docker host. These are then used with Docker volumes for creating the same state in subsequent Openfire and database containers.