Steps

To run XWiki with PostgreSQL using Docker Swarm:

1. Enable Docker Swarm mode.

   docker swarm init

2. Create the required Docker secrets.
   1. Create a secret for the database username.
      • For Unix systems:

        echo ${MY_XWIKI_USER:-xwiki} | docker secret create xwiki-db-username -

      • For Windows systems:

        echo $env:MY_XWIKI_USER | docker secret create xwiki-db-username -

   2. Create a secret for the database password.

      echo YourDBPassword | docker secret create xwiki-db-password -

   3. Create a secret for the PostgreSQL root password.

      echo YourRootPassword | docker secret create xwiki-db-root-password -

3. Create a stack definition file named xwiki-stack.yaml.

   version: '3.3'
   
   services:
     web:
       image: "xwiki:stable-postgres-tomcat"
       ports:
         - "8080:8080"
       environment:
         - DB_USER_FILE=/run/secrets/xwiki-db-username
         - DB_PASSWORD_FILE=/run/secrets/xwiki-db-password
         - DB_DATABASE=xwiki
         - DB_HOST=db
       volumes:
         - xwiki-data:/usr/local/xwiki
       secrets:
         - xwiki-db-username
         - xwiki-db-password
   
     db:
       image: "postgres:17"
       volumes:
         - postgres-data:/var/lib/postgresql/data
       environment:
         - POSTGRES_ROOT_PASSWORD_FILE=/run/secrets/xwiki-db-root-password
         - POSTGRES_USER_FILE=/run/secrets/xwiki-db-username
         - POSTGRES_PASSWORD_FILE=/run/secrets/xwiki-db-password
         - POSTGRES_DB=xwiki
       secrets:
         - xwiki-db-username
         - xwiki-db-password
         - xwiki-db-root-password
   
   volumes:
     postgres-data:
     xwiki-data:
   
   secrets:
     xwiki-db-username:
       external: true
     xwiki-db-password:
       external: true
     xwiki-db-root-password:
       external: true

1. Deploy the stack.

   docker stack deploy -c xwiki-stack.yaml xwiki

2. Verify that the services are running.

   docker service ls

3. Open XWiki in your browser at http://localhost:8080. Both services should show 1/1 under REPLICAS. This may take a few minutes.

Don't forget to replace example values such as ${MY_XWIKI_USER:-xwiki}, $env:MY_XWIKI_USER,, passwords, image tags, database names, and hostnames with values that match your environment.

FAQ

What if I want to generate a random password instead of choosing one?

You can create random passwords for xwiki-db-password, or for xwiki-db-root-password as it follows:

• On Unix systems:

  echo $(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 16 | head -n 1) | docker secret create xwiki-db-password -

• On Windows:

  -join ((48..57) + (65..90) + (97..122) | Get-Random -Count 16 | % {[char]$_}) | docker secret create xwiki-db-root-password -

Why do my secrets fail (on Windows)?

Windows CMD's echo command adds a trailling space to the value, which can cause authentication errors. You may use PowerShell instead.

Related

• Run XWiki (MySQL on Tomcat) using Docker Swarm.
• Run XWiki (PostgreSQL on Tomcat) using Docker Swarm.
• Database Support Strategy.