How to get DokuWiki Up and Running?

Install Docker

Download the Docker binary or install a package as explained on this article.

On Windows?

On Windows, you need to install WSL by following this instructions. Why? Because Php is still a Linux and C technology that is really slow on Windows. This is architectural as explained on this issue

Create a data directory

• Create a directory to store the DokuWiki Data

mkdir -p ~/site-combo-starter

• And go into it to change the current directory

cd site-combo-starter

Start DokuWiki in Docker

Start a DokuWiki Docker Instance with the following command.

docker run \
  --name site-combo-starter \
  --rm \
  -p 8080:80 \
  --user 1000:1000 \
  -e DOKU_DOCKER_ACL_POLICY='public' \
  -e DOKU_DOCKER_ADMIN_NAME='admin' \
  -e DOKU_DOCKER_ADMIN_PASSWORD='welcome' \
  -v $PWD:/var/www/html \
  ghcr.io/combostrap/dokuwiki:php8.3-latest

where:

• DOKU_DOCKER_ACL_POLICY='public' will configure a wiki that can only be seen by the public. You need to login to modify it.
• DOKU_DOCKER_ADMIN_NAME='admin' create a user named admin with the admin permission.
• DOKU_DOCKER_ADMIN_PASSWORD='welcome' is the password of the admin user
• -v $PWD:/var/www/html mount your current directory PWD into the image at the HTML server root /var/www/html
• –user 1000:1000 will create file as if it were you creating them. The user 1000 is the UID of your Desktop user (in Windows WSL at least)

Check that the instance has started

The command above will:

• start php,
• install DokuWiki,
• install the starter site
• and is ready when you see this lines:

INFO success: caddy entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
INFO success: php_error_log entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
INFO success: php_fpm entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)

• You can then access DokuWiki at http://localhost:8080

docker stop site-combo-starter

Login

Go to the login page: http://localhost:8080/?do=login

And enter the credentials:

• user: admin
• password: welcome