XWiki

I’d call this the enterprise-like choice. Best if you’re going to build processes and flows around it.

These notes are circa 2020 so use with some caution.

Installation

We’ve chosen the docker option detailed in the installation options on their web site and gone with PostgreSQL simply because Oracle now owns MySQL. Minor changes to the docker start scripts are detailed below.

This gets the wiki running on port 8080. To add a layer of security, pair this with secure reverse proxy such as [HAProxy].

XWiki Setup

This is based on the well documented docker option with a restart option added so they come up after a container reboot.

The first step is to create the user-defined network so the containers to talk to each other privately and connect using their container names as hostnames¹.

docker network create -d bridge xwiki-nw

Run the database. We deviate from the instructions and install the current version of postgres. Set the passwords and take note of one you use for YYYYYY and reuse below

docker run \
--net=xwiki-nw \
--name postgres-xwiki \
-v /my/own/postgres:/var/lib/postgresql/data \
-e POSTGRES_ROOT_PASSWORD=XXXXXXXX \
-e POSTGRES_USER=xwiki \
-e POSTGRES_PASSWORD=YYYYYYYY \
-e POSTGRES_DB=xwiki \
-e POSTGRES_INITDB_ARGS="--encoding=UTF8" \
--detach \
--restart=always \
postgres:9.5

Run the xwiki tomcat container with the corresponding password.

docker run \
--net=xwiki-nw \
--name xwiki \
-p 8080:8080 \
-v /my/own/xwiki:/usr/local/xwiki \
-e DB_USER=xwiki \
-e DB_PASSWORD=YYYYYYYY \
-e DB_DATABASE=xwiki \
-e DB_HOST=postgres-xwiki \
--detach \
--restart=always \
xwiki:stable-postgres-tomcat

The install will prompt you to pick a flavor. Definitely pick the Standard Flavor. Picking none leaves you without all the default pages that are handy.

The installation takes a very, very long time.

If all went as planned, you can now connect to your docker host on port 8080 and see the wiki. If not, connect with a bash shell and investigate the logs folder

docker exec -it xwiki bash

Upgrade

We’ve followed the upgrade several times, checked the release note each time and not had a successful upgrade.

You can export the pages, install a fresh wiki and import.