DokuWiki is an easy-to-use and versatile open source wiki program that does not require a database. It is loved by users due to its clean, easy-to-read formula. Ease of maintenance, easy backup, and integration make it an admin’s favorite.
Built-in access control and authentication connectors make DokuWiki extremely useful in an enterprise context and the large number of plugins contributed by its active community allows for a variety of use cases outside of traditional wikis.
This tutorial will show you how to install DokuWiki on a new CentOS 8 server.
DokuWiki requirements
Make sure your server meets the following requirements.
- Web server software that supports PHP (Apache, NGINX, IIS, Lighttpd, LiteSpeed)
- PHP version 5.6 or later, newer version is highly recommended.
precondition
- Server with CentOS 8.
- Log in as root or a user with sudo privileges
Initial step
Check your CentOS version:
cat /etc/centos-release # CentOS Linux release 8.0.1905 (Core)
Prepare the server’s timezone, in this example we’ll set the timezone to Asia / Jakarta:
timedatectl list-timezones sudo timedatectl set-timezone 'Asia/Jakarta'
Update the operating system (software) package. This is an important first step as it ensures that you have the latest updates and security fixes for the default software packages for your operating system:
sudo dnf update -y
Install some basic packages required for basic CentOS management:
sudo dnf install -y curl wget vim git unzip socat bash-completion epel-release
Step 1 – Install PHP and PHP Extensions
Install the required PHP and PHP extensions:
sudo dnf install -y php php-cli php-fpm php-gd php-xml php-zip
To display a bulk PHP module, you can run:
php -m ctype curl exif fileinfo . . . . . .
Check PHP version:
php --version # PHP 7.2.11-1-(cli) (built: Oct 26 2019 14:14:18) ( NTS ) # Copyright (c) 1997-2018 The PHP Group # Zend Engine v3.3.11, Copyright (c) 1998-2018 Zend Technologies # with Zend OPcache v7.3.11-1~deb10u1, Copyright (c) 1999-2018, by Zend Technologies
Initiate and activate PHP-FPM with the command:
sudo systemctl start php-fpm.service sudo systemctl enable php-fpm.service
Step 2 – Install the Acme.sh Client and Install Let’s Encrypt Certificate (Optional)
Securing your website with HTTPS is very important, and it is a good practice to secure your site traffic. To get an SSL certificate from Let’s Encrypt we will be using the Acme.sh client.
Acme.sh is a pure Unix Shell program to get SSL certificates from Let’s Encrypt without dependencies.
Download and install Acme.sh:
sudo su - root git clone https://github.com/Neilpang/acme.sh.git cd acme.sh ./acme.sh --install --accountemail [email protected] source ~/.bashrc cd ~
Check the version of Acme.sh:
acme.sh --version # v2.8.2
Get certified RSA And the ECC / ECDSA For your domain / hostname:
# RSA 2048 acme.sh --issue --standalone -d example.com --keylength 2048 # ECDSA acme.sh --issue --standalone -d example.com --keylength ec-256
If you want to create a fake test certificate, you can add a flag --stagingFor the above command.
After executing the above command, Certificates And the Keys It will be in:
- to me RSA In the manual:
/home/username/example.com. - to me ECC / ECDSA In the manual:
/home/username/example.com_ecc.
To list all certificates, run the command:
acme.sh --list
Create a directory to store your certificates. We will use directories /etc/letsencrypt
mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc
Install / copy certificate to directory /etc/letsencrypt.
# RSA acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service" # ECC/ECDSA acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
All certificates will be renewed automatically every 60 days.
After obtaining the certificate, terminate the root user and revert to the normal user with their rights sudo :
exit
Step 3 – Install and configure Nginx
DokuWiki will run on any web server that supports PHP. For this tutorial, we’ll be using Nginx. If you prefer Apache or another web server, you can use it in place of Nginx.
Download and install NGINX from the default CentOS repositories:
sudo dnf install -y nginx
Check out the NGINX version:
sudo nginx -v # nginx version: nginx/1.14.2
Next, configure NGINX for the DokuWiki CMS. We will create a server block for DokuWiki and add the following configuration.
sudo nano /etc/nginx/conf.d/dokuwiki.conf
Copy / paste the following Nginx configuration and save it:
server {
listen [::]:443 ssl;
listen 443 ssl;
listen [::]:80;
listen 80;
# RSA
ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
# ECC
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;
server_name wiki.example.com;
root /var/www/dokuwiki;
index index.html index.htm index.php doku.php;
client_max_body_size 15M;
client_body_buffer_size 128K;
location / {
try_files $uri $uri/ @dokuwiki;
}
location ^~ /conf/ { return 403; }
location ^~ /data/ { return 403; }
location ~ /.ht { deny all; }
location @dokuwiki {
rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
rewrite ^/(.*) /doku.php?id=$1 last;
}
location ~ .php$ {
try_files $uri =404;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
Check NGINX configuration for no syntax errors:
sudo nginx -t
Reload Nginx with the following command
sudo systemctl reload nginx.service
Step 4 – Install DokuWiki
Create a document root directory for DokuWiki
sudo mkdir -p /var/www/dokuwiki
Enter the document’s root directory:
cd /var/www/dokuwiki
Download the latest version of DokuWiki from the DokuWiki download page with the command wget:
sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
The command below will extract the DokuWiki tarball file, delete the dokuwiki-stabil.tgz tar archive and move the extracted file to the document root:
sudo tar xvf dokuwiki-stable.tgz sudo rm dokuwiki-stable.tgz sudo mv dokuwiki-2018-04-22b/* . && mv dokuwiki-2018-04-22b/.* . sudo rmdir dokuwiki-2018-04-22b/
Change ownership of the directory /var/www/dokuwiki Becomewww-data:
sudo chown -R nginx:nginx /var/www/dokuwiki
Then restart php7.3-fpm.service:
sudo systemctl restart php7.3-fpm.service
Step 5 – Install DokuWiki Web Interface
Open a web browser and type the URL http://example.com/install.php. You will be directed to the following page:
Provide all necessary information such as your superusername, email, and password. Then click the button save. After successful installation, you will see the following page:
Now, click Your new DokuWiki. You will see the following page:
Now, click on the button sign in. You will be directed to the following page:
Now, enter the administrator username and password. Then click the button Record in a. You should see the DokuWiki dashboard on the following page:
After successful configuration, delete the file install.php From a DokuWiki root directory:
sudo rm /var/www/dokuwiki/install.php
Congratulations! You have successfully installed and configured DokuWiki on the CentOS 8 server. Now you can easily create your own wiki using DokuWiki.
.
