Search

Undraw Stepping Up

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




Showcase yourself and your brand

Get free news, tips, and tricks
to create a remarkable experience for your readers.




Related HowTo's
Combostrap Default Theme File Explorer
How to create your own theme?

This page shows you how to create your own theme. You can then apply advanced design and logic to your whole website application. Combostrap uses a theme system where: each page has its own template...
Undraw Stepping Up
How to get started with ComboStrap ?

This page helps you to get started with ComboStrap
Dokuwiki Admin Window Default Template
How to install Combo ?

Combo is the bundle of components that complements the strap template. This step shows you how to install it.
Undraw Stepping Up
How to store your site in Git?

This page will show you how to store your site as combo site in a remote Git repository. We will be using GitHub as example, but you can use any Git Repository Provider such as...
Move Plugin Rename
Third Party Plugins

This page is an optional and informative step that highlights important information that you should now about third party plugins.




Task Runner