This image is based on the official PHP Apache image and provides a DokuWiki installation. It is meant to be used with a reverse proxy that handles SSL termination and authentication. It's probably not worth it to use this image for a standalone installation (read Running DokuWiki on Docker for alternatives). Running Docker without a proper understanding of Linux, networking and Docker itself is not recommended. If you are a novice, you should probably use a shared hosting provider instead.
docker run -p 8080:8080 --user 1000:1000 -v /path/to/storage:/storage dokuwiki/dokuwiki:stable
- Exposed Port:
8080
- Volume:
/storage
- Can be run as non-root user. Be sure the storage volume is writable by the given uid.
- Available tags:
stable
,oldstable
,master
and versions like2020-07-29a
.latest
is an alias forstable
.
An example docker-compose file is included in the repository.
On first run, use DokuWiki's installer to configure the wiki as usual.
- xsendfile configured and enabled
- imagemagick installed and enabled
- nice URLs via rewriting configured and enabled
- farming support via the farmer plugin
- docker health check running basic DokuWiki checks (every 30 seconds, 3 retries)
Note: This image does not include a mail server. You need to configure DokuWiki to use an external mail server, this is most easily achieved using the SMTP plugin.
The container runs the standard production php.ini. Some options can be set via environment variables:
PHP_UPLOADLIMIT
- File upload size limit. Default128M
PHP_MEMORYLIMIT
- Process Memory Limit. Default256M
PHP_TIMEZONE
- The timezone. DefaultUTC
Custom PHP configuration values can be set in a php.ini
file in the storage volume.
This image supports farming via the farmer plugin. To use it, install the
plugin and configure it as described in the plugin documentation. The initial farm configuration is already done in this
image. The farm directory is /storage/farm
.
Use a reverse proxy to route animal requests to this container.
Besides the obvious page and media data, extensions and configuration need to be persisted over container replacements. However, it needs to be differentiated between user installed extensions and configuration and bundled extensions and configuration.
This image uses a single storage volume for all user data.
Bundled Plugins and Templates are moved to separate directories in the container and symlinked to the storage volume. The storage volume is then symlinked to the proper tpl and plugins location. This means that the storage volume will never contain stale bundled extensions.
Similarly, the core configuration is moved to a separate directory but the preload mechanism is used to load them as default. The storage volume will only contain local configuration this way.
Required symlinks are rechecked on every container restart.
This setup ensures that all adjustments you may make via the Admin interface will be stored correctly in the storage volume while all bundled data is kept in the container and is correctly updated/replaced when the container is updated.
To manually build the image:
docker build --build-arg="DOKUWIKI_VERSION=stable" -t dokuwiki/dokuwiki:stable .
Builds and deployments are currently done daily using the GitHub Actions workflow.