Hi,
I recently ran into a problem when trying to upgrade the docker-compose stack from XWiki 18.1.0 to 18.3.0.
As I followed the official guide for upgrading docker instances, I got no further than actually upgrading the web-container following the guide: xwiki-docker/README.md at master · xwiki/xwiki-docker · GitHub
After starting the container and logging in with using the global admin account, the Distribution Wizard did not come up. Viewing the log, this appeared, suggesting the older version ist still in place:
xwiki-mariadb-tomcat-web | 2026-06-02 13:37:26,954 [XWiki initialization] INFO .HibernateDataMigrationManager - Storage schema updates and data migrations are enabled
xwiki-mariadb-tomcat-web | 2026-06-02 13:37:27,098 [XWiki initialization] INFO .HibernateDataMigrationManager - No data migration to apply for wiki [xwiki] currently in version [180100000]
Docker Containers Overview and compose file:
d6dbc190bd44 xwiki:18.3.0-mariadb-tomcat "docker-entrypoint.s…" 48 seconds ago Up 46 seconds 0.0.0.0:80->8080/tcp, [::]:80->8080/tcp xwiki-mariadb-tomcat-web
e5f14b7c74f0 mariadb:12 "docker-entrypoint.s…" 3 minutes ago Up 3 minutes 3306/tcp xwiki-mariadb-db
networks:
bridge:
driver: bridge
services:
# The container that runs XWiki in Tomcat, with the appropriate JDBC driver (for mariadb).
web:
image: "xwiki:${XWIKI_VERSION}-mariadb-tomcat"
container_name: xwiki-mariadb-tomcat-web
depends_on:
- db
ports:
- "80:8080"
# Default values defined in .env file.
# The DB_USER/DB_PASSWORD/DB_DATABASE/DB_HOST variables are used in the hibernate.cfg.xml file.
environment:
- XWIKI_VERSION="${XWIKI_VERSION}"
- DB_USER=XXX
- DB_PASSWORD="${DB_PASSWORD}"
- DB_DATABASE=XXX
- DB_HOST=xwiki-mariadb-db
- JAVA_OPTS=-Xms2048m -Xmx8192m -Djava.awt.headless=true
# Provide a name instead of an auto-generated id for xwiki data (the permanent directory in included in it)
# configured in the Dockerfile, to make it simpler to identify in 'docker volume ls'.
volumes:
- ./xwiki.cfg:/usr/local/tomcat/webapps/ROOT/WEB-INF/xwiki.cfg
- ./xwiki.properties:/usr/local/tomcat/webapps/ROOT/WEB-INF/xwiki.properties
- /xwiki/data/xwiki:/usr/local/xwiki
- /xwiki/tomcat:/usr/local/tomcat
networks:
- bridge
# The container that runs the database (mariadb)
db:
image: "mariadb:12"
container_name: xwiki-mariadb-db
# - Provide a name instead of an auto-generated id for the mariadb data, to make it simpler to identify in
# 'docker volume ls'
# - Provide a SQL script to be executed when the db image starts (to set permissions to create subwikis)
volumes:
- /xwiki/data/mariadb:/var/lib/mysql
- ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro
# Configure the MariaDB database and create a user with provided name/password.
# See https://hub.docker.com/_/mariadb/ for more details.
# Default values defined in .env file.
environment:
- MYSQL_ROOT_PASSWORD="${MYSQL_ROOT_PASSWORD}"
- MYSQL_USER=XXX
- MYSQL_PASSWORD="${DB_PASSWORD}"
- MYSQL_DATABASE=XXX
# Pass arguments to configure the database
command:
- "--character-set-server=utf8mb4"
- "--collation-server=utf8mb4_bin"
- "--explicit-defaults-for-timestamp=1"
- "--innodb-use-native-aio=0"
networks:
- bridge
Unfortunately, this guide proved ineffective: https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/DistributionWizard#HThewizardfailstoappearatstartup
You got any further ideas on how to trigger the Wizard?