Docker container for MediaWiki running under Nginx and PHP-FPM. Based on the official PHP7 images.

Packaged with the VisualEditor plugin and its dependant Parsoid service.

This container is running 3 processes (Nginx, PHP-FPM, Parsoid) controlled by supervisord.

For a basic understanding of docker please refer to the official documentation.

• Supported Tags
• Features
• Changelog
• Usage
  • With MySQL
  • With SQLite
• Configuration
  • General
  • Uploads
  • E-Mail
  • Logo
  • Skins
  • Extensions
  • HTTPS
  • Additional configuration
  • Configuration file
  • Performance
• Configuration reference
• Extending this image
• Security
• Contributing
• License

• 1.30 (Dockerfile)
• 1.29 (Dockerfile)
• 1.28 (Dockerfile)
• 1.27 (Dockerfile)

• MediaWiki 1.35.1
• Nginx
• PHP-FPM with PHP7
• VisualEditor plugin
• UserMerge plugin
• Parsoid running on NodeJS v4.6.x LTS
• Imagick for thumbnail generation
• Intl for Unicode normalization
• APC as in memory PHP object cache
• Configured with Short URLs

See CHANGELOG.md for information about the latest changes.

Please note that version 1.30 has some breaking changes.

See Docker Compose example.

Start a MySQL container.

docker run --name=mediawiki_mysql \
-e MYSQL_DATABASE=wikidb \
-e MYSQL_USER=wikiuser \
-e MYSQL_PASSWORD=mysecret \
-e MYSQL_RANDOM_ROOT_PASSWORD=1 \
-v /var/mediawiki/mysql:/var/lib/mysql \
-d mysql:5.7

Start MediaWiki container.

docker run --name mediawiki_wiki \
--link mediawiki_mysql:mediawiki_mysql \
-p 8080:8080 \
-e MEDIAWIKI_SERVER=https://localhost:8080 \
-e MEDIAWIKI_SITENAME=MyWiki \
-e MEDIAWIKI_LANGUAGE_CODE=en \
-e MEDIAWIKI_DB_TYPE=mysql \
-e MEDIAWIKI_DB_HOST=mediawiki_mysql \
-e MEDIAWIKI_DB_PORT=3306 \
-e MEDIAWIKI_DB_NAME=wikidb \
-e MEDIAWIKI_DB_USER=wikiuser \
-e MEDIAWIKI_DB_PASSWORD=mysecret \
-e MEDIAWIKI_ENABLE_UPLOADS=1 \
-v /var/mediawiki/images:/images \
-d kristophjunge/mediawiki

Create a new database with the install script. Insert username and password for your admin account.

docker exec -it mediawiki_wiki /script/install.sh <username> <password>

If you are using an existing database run the update script instead.

docker exec -it mediawiki_wiki /script/update.sh

Copy the secret key that the install script dumps or find the variable $wgSecretKey in your previous LocalSettings.php file and put it into an environment variable.

-e MEDIAWIKI_SECRET_KEY=secretkey

If you are using an existing database find the variable $wgDBTableOptions in your previous LocalSettings.php file and put it into an environment variable.

-e MEDIAWIKI_DB_TABLE_OPTIONS=ENGINE=InnoDB, DEFAULT CHARSET=binary

You should be able to browse your wiki at https://localhost:8080.

See Docker Compose example.

Start MediaWiki container.

docker run --name=mediawiki_wiki \
-p 8080:8080 \
-e MEDIAWIKI_SERVER=https://localhost:8080 \
-e MEDIAWIKI_SITENAME=MyWiki \
-e MEDIAWIKI_LANGUAGE_CODE=en \
-e MEDIAWIKI_DB_TYPE=sqlite \
-e MEDIAWIKI_DB_NAME=wikidb \
-e MEDIAWIKI_ENABLE_UPLOADS=1 \
-v /var/mediawiki/images:/images \
-v /var/mediawiki/data:/data \
-d kristophjunge/mediawiki

Create a new database with the install script. Insert username and password for your admin account.

docker exec -it mediawiki_wiki /script/install.sh <username> <password>

If you are using an existing database run the update script instead.

docker exec -it mediawiki_wiki /script/update.sh

Copy the secret key that the install script dumps or find the variable $wgSecretKey in your previous LocalSettings.php file and put it into an environment variable.

-e MEDIAWIKI_SECRET_KEY=secretkey

You should be able to browse your wiki at https://localhost:8080.

Set the mandatory environment variables:

• Set MEDIAWIKI_SERVER to your wiki's primary domain, prefixed with the primary protocol.
• Set MEDIAWIKI_SITENAME to your wiki's name.
• Set MEDIAWIKI_LANGUAGE_CODE to a language code of this list.

-e MEDIAWIKI_SERVER=https://wiki.example.com \
-e MEDIAWIKI_SITENAME=MyWiki \
-e MEDIAWIKI_LANGUAGE_CODE=en

To enable file uploads set the environment variable MEDIAWIKI_ENABLE_UPLOADS to 1.

-e MEDIAWIKI_ENABLE_UPLOADS=1

Mount a writable volume to the images folder.

-v /var/mediawiki/images:/images

Which file extensions are allowed for uploading can be controlled with the environment variable MEDIAWIKI_FILE_EXTENSIONS.

-e MEDIAWIKI_FILE_EXTENSIONS=png,gif,jpg,jpeg,webp,pdf

The maximum size for file uploads can be controlled with the environment variable MEDIAWIKI_MAX_UPLOAD_SIZE.

-e MEDIAWIKI_MAX_UPLOAD_SIZE=100M

SMTP E-Mail can be enabled by setting MEDIAWIKI_SMTP to 1. TLS auth will be used by default.

-e MEDIAWIKI_SMTP=1
-e MEDIAWIKI_SMTP_HOST=smtp.example.com
-e MEDIAWIKI_SMTP_IDHOST=example.com
-e MEDIAWIKI_SMTP_PORT=587
-e MEDIAWIKI_SMTP_AUTH=1
-e [email protected]
-e MEDIAWIKI_SMTP_PASSWORD=secret

Using a self-signed certificate will not work because of failing peer verification. If you know the security implications you can disable peer verification by setting MEDIAWIKI_SMTP_SSL_VERIFY_PEER to 0.

You can setup your own logo by mounting a PNG file.

-v ./var/mediawiki/logo.png:/var/www/mediawiki/resources/assets/wiki.png:ro

You can change the default skin by setting the environment variable MEDIAWIKI_DEFAULT_SKIN.

-e MEDIAWIKI_DEFAULT_SKIN=vector

The default skins are packaged with the container:

• cologneblue
• modern
• monobook
• vector

You can add more skins by mounting them.

-v ./var/mediawiki/skins/MyOtherSkin:/var/www/mediawiki/skins/MyOtherSkin:ro

HTTPS is not longer supported by the container itself. Its recommended to use a proxy container for HTTPS setups.

Make sure that you set the MEDIAWIKI_SERVER environment variable to the outside URL of your wiki and to apply the https prefix.

-e MEDIAWIKI_SERVER=https://localhost

You can add more extensions by mounting them.

-v ./var/mediawiki/extensions/MyOtherExtension:/var/www/mediawiki/extensions/MyOtherExtension:ro

You can add own PHP configuration values by mounting an additional configuration file that is loaded at the end of the generic configuration file.

-v /var/mediawiki/ExtraLocalSettings.php:/var/www/mediawiki/ExtraLocalSettings.php:ro

A good starting point is to copy the file that's inside the container. You can display its content with the following command.

docker exec -it mediawiki_wiki cat /var/www/mediawiki/ExtraLocalSettings.php

Beside the docker like configuration with environment variables you still can use your own full LocalSettings.php file.

However this will make all environment variables unusable except MEDIAWIKI_HTTPS and MEDIAWIKI_SMTP_SSL_VERIFY_PEER.

-v /var/mediawiki/LocalSettings.php:/var/www/mediawiki/LocalSettings.php:ro

The container has some performance related configuration options. If you have more advanced needs you can override the configuration inside the container by mounting configuration files.

The number of PHP-FPM worker processes can be configured with the environment variables PHPFPM_WORKERS_START, PHPFPM_WORKERS_MIN and PHPFPM_WORKERS_MAX.

-e PHPFPM_WORKERS_START=10
-e PHPFPM_WORKERS_MIN=10
-e PHPFPM_WORKERS_MAX=20

Default for start and min is 1. Default for max is 20, so up to 20 worker processes will be spawned dynamically when needed.

For a more advanced configuration of PHP-FPM mount a configuration file to /usr/local/etc/php-fpm.conf.

-v /var/mediawiki/php-fpm.conf:/usr/local/etc/php-fpm.conf:ro

The number of Parsoid worker processes can be configured with the environment variable PARSOID_WORKERS.

-e PARSOID_WORKERS=10

Default is 1. Please note that the number of Parsoid workers is not managed dynamically. Make sure that you spawn enough workers for your requirements.

For a more advanced configuration of Parsoid mount a configuration file to /usr/lib/parsoid/src/config.yaml.

-v /var/mediawiki/config.yaml:/usr/lib/parsoid/src/config.yaml:ro

Below is a list of all environment variables supported by the container.

When using an own LocalSettings.php file according to the section "Configuration file" most variables be unusable.

To modify configuration values that are not listed below read the section "Additional configuration".

More information about the configuration values can be found at MediaWiki's documentation.

If you need to create your own Dockerfile you can extend this image.

FROM kristophjunge/mediawiki:latest

COPY ./LocalSettings.php /var/www/mediawiki/LocalSettings.php

# ...

• Nginx and PHP-FPM worker processes run under the www-data user with UID 999 and GID 999.
• Parsoid runs under the parsoid user.
• Parsoid runs only inside the container. There is no port exposed.
• The MediaWiki files are owned by root. Only the images folder is owned by www-data.
• The Parsoid files are all owned by root.
• During container build signatures and keys of installed software is verified where possible.

See CONTRIBUTING.md for information on how to contribute to the project.

See CONTRIBUTORS.md for the list of contributors.

This project is licensed under the MIT license by Kristoph Junge.