Run XWiki (MariaDB on Tomcat) Using Docker Compose
Last modified by Vincent Massol on 2026/07/27 16:43
Steps
To run XWiki using Docker Compose with a MariaDB + Tomcat setup:
- Create a working directory, for example /xwiki.
- Go to the /xwiki directory.
- Download the required configuration files:
- Run the following commands with wget:
wget https://raw.githubusercontent.com/xwiki/xwiki-docker/master/<cycle_version>/mariadb-tomcat/mariadb/init.sqlwget -O docker-compose.yml https://raw.githubusercontent.com/xwiki/xwiki-docker/master/<cycle_version>/mariadb-tomcat/docker-compose.ymlwget https://raw.githubusercontent.com/xwiki/xwiki-docker/master/<cycle_version>/mariadb-tomcat/.env
- Or, if you prefer to use curl:Don't forget to replace <cycle_version> with the actual XWiki cycle version you want. For example:
curl -fSL https://raw.githubusercontent.com/xwiki/xwiki-docker/master/<cycle_version>/mariadb-tomcat/mariadb/init.sql -o init.sqlcurl -fSL https://raw.githubusercontent.com/xwiki/xwiki-docker/master/<cycle_version>/mariadb-tomcat/docker-compose.yml -o docker-compose.ymlcurl -fSL https://raw.githubusercontent.com/xwiki/xwiki-docker/master/<cycle_version>/mariadb-tomcat/.env -o .env
wget https://raw.githubusercontent.com/xwiki/xwiki-docker/master/18/mariadb-tomcat/mariadb/init.sql
- Run the following commands with wget:
- Run Docker Compose to pull the images and start the containers: docker compose up -d.
FAQ
How can I check that XWiki is running?
Run: docker ps. If XWiki is running correctly, you should see active containers for XWiki and for its database.
What are the files init.sql, docker-compose.yml, .env used for?
These are some required files for XWiki Docker Compose.