Prebuilt vs. Custom XWiki Docker Images

Last modified by Vincent Massol on 2026/07/27 15:33

Explanation

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

ApproachWhen to useBehaviorHow 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 to build a new image locally with docker build, which you then reference from docker-compose.yml.

Related

Get Connected