Table of Contents

About

Because ComboStrap is built on top of the Dokuwiki Engine, the first step is to have a DokuWiki app up and running.

This article will show you how.

Docker / Server

This tutorial series uses our Docker image for consistency but if you have a standalone server and want to install DokuWiki on it, you can also follow this tutorial series.

Steps

We recommend greatly to use our DokuWiki in Docker image as:

  • it's the easiest way to get DokuWiki up and running
  • it contains all performance cache system (php-fpm and opcache)
  • a Server DokuWiki installation is not easy and straightforward
  • and more.

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)

Site Starter Home Page Snapshot

How to stop the instance

If you want to stop the instance:

  • you can press Control+C with your keyboard in the current terminal
  • Or you can open another terminal and stop it with the following command
docker stop site-combo-starter

Login

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

And enter the credentials:

  • user: admin
  • password: welcome

Next Step

In the next step, you will learn to install a favicon

Configure a Favicon