Prebuilt vs. Custom XWiki Docker Images

Last modified by Eleni Cojocariu on 2026/04/29 08:44

Explanation

Warning

WIP

When running XWiki with Docker, you have two main approaches:

ApproachWhen to useBehaviourHow it works
Using a Prebuilt XWiki ImageUse when you simply want to run XWiki.
  • Docker pulls an existing image and starts it (e.g.,docker compose up). 
  • No build step is needed.
Uses a prebuilt image.
Building the Image Locally

Very advanced, when you need more control over what is in the Dockerfile, such as:

  • testing a patch or modified version of XWiki,
  • developing or debugging XWiki internals,
  •  adding other software in that Docker Image (e.g., other editors).

Docker builds a new image locally, then runs it. During the build process, Docker:

  • starts from a base image (e.g., Tomcat),
  • applies configuration,
  • produces a new local image.

Docker uses a Dockerfile  (or build: section in docker-compose.yml) to create a new image.

Get Connected