Original Author: https://hub.docker.com/u/mprasil

Original Source: https://hub.docker.com/r/mprasil/dokuwiki

''docker run -d -p 80:80 --name my_wiki mprasil/dokuwiki ''

You can now visit the install page to configure your new DokuWiki wiki.

For example, if you are running container locally, you can acces the page in browser by going to http://127.0.0.1/install.php

The run command above will store your data in internal Docker volumes. If you prefer to bind mount directories on your file system, then you can use the -v parameter, for example:

''docker run -d -p 80:80 --name my_wiki \
    -v /data/docker/dokuwiki/data:/dokuwiki/data \
    -v /data/docker/dokuwiki/conf:/dokuwiki/conf \
    -v /data/docker/dokuwiki/lib/plugins:/dokuwiki/lib/plugins \
    -v /data/docker/dokuwiki/lib/tpl:/dokuwiki/lib/tpl \
    -v /data/docker/dokuwiki/logs:/var/log \
    mprasil/dokuwiki''

When running the container you can specify version to download from docker registry by using couple provided tags like stable which contains current stable release (this is generaly the same as latest) or oldstable. You can also use specific version like 2016-06-26a.

First stop your container

''docker stop my_wiki''

Then run new container just to hold the volumes

''docker run --volumes-from my_wiki --name my_wiki_data busybox true''

Now you can remove old container

''docker rm my_wiki''

..and run a new one (you built, pulled before)

''docker run -d -p 80:80 --name my_wiki --volumes-from my_wiki_data mprasil/dokuwiki ''

afterwards you can remove data container if you want

''docker rm my_wiki_data''

(or keep it for next update, takes no space anyway..)

Just stop the old container and run the new one with the same -v mapping. Since the data is on your file system, you do not need to do anything special to preserve it between containers.

Note: The functionality bellow is currently only supported in latest, stable-bind and 2017-02-19e-bind tags. This is to preserve original functionality in old images. Future releases will all support the new update system.

If you mount a volume that has previously been used with a newer version of DokuWiki than that installed in the current contaier, the newer files will not be overwritten by those bundled with the current (older) version of DokuWiki. If you want to force a downgrade (at your own risk!), run the container with the downgrade command:

''docker run ... mprasil/dokuwiki donwgrade''

Additionally, if you make any changes to the files bundled with DokuWiki that are located in your volumes, these can be restored to the original version using the overwrite command:

''docker run ... mprasil/dokuwiki overwrite''

Lighttpd configuration also includes rewrites, so you can enable nice URLs in settings (Advanced → Nice URLs, set to “.htaccess”)

For better performance enable xsendfile in settings. Set to proprietary lighttpd header (for lighttpd < 1.5)

''docker build -t my_dokuwiki .''