MediaWiki-Docker/Configuration recipes/Customize base image
Appearance
Sometimes we need to customize the base image used for mediawiki. For example, we may need to install additional packages. To do that follow the below steps:
Modify the mediawiki
service in docker-compose.override.yml
as follows:
services:
mediawiki:
# On Linux, these lines ensure file ownership is set to your host user/group
user: "${MW_DOCKER_UID}:${MW_DOCKER_GID}"
build:
context: ./path/to/custom/Dockerfile/Directory
dockerfile: Dockerfile
mediawiki-web:
user: "${MW_DOCKER_UID}:${MW_DOCKER_GID}"
In that custom Dockerfile
, build everything on top of base image. Suppose, we want to install imagemagick
# Important: Make sure the version here matches the latest version of the mediawiki image in docker-compose.yml
FROM docker-registry.wikimedia.org/dev/buster-php81-fpm:1.0.1-s2
RUN apt update && \
apt install -y imagemagick
# Add any additional image preparation code here.
The base image (e.g. buster-php81-fpm:1.0.1-s2
should match that used for the mediawiki
service in the docker-compose.yml
file.
You should run docker compose build
after changing this Dockerfile.