Install and run DokuWiki the most versatile Wiki on a CentOS 7 VPS

Install and run DokuWiki the most versatile Wiki on a CentOS 7 VPSIn the following article, we’ll explain how you can install and run DokuWiki on a CentOS 7 server. We support DokuWiki running on all our SSD VPS hosting plans and with our DokuWiki hosting stack, you’ll get DokuWiki pre-loaded on your virtual server, making your wiki up and running in no-time.

Sweet!

What is DokuWiki?

DokuWiki is considered to be the most versatile open source Wiki software application which is proven to meet your demanding wiki needs.

DokuWiki does not require a database and it’s extremely simple and easy to use. Check out DokuWiki features to learn more.

System Requirements?

  • Webserver such as Apache, Nginx etc..
  • PHP server version 5.2 or later
  • PHP-GD / Image Magick library

 

UPDATE THE SYSTEM

Before proceeding with the actual DokuWiki installation, ssh to your CentOS 7 SSD VPS, initiate a screen session and upgrade your system using yum:

## screen -U -S dokuwiki-screen
## yum update

 

INSTALL SOME PACKAGES

Install some useful packages on your CentOS SSD powered virtual server:

## yum install wget unzip vim

 

INSTALL APACHE WEBSERVER

In this set-up we are going to serve DokuWiki using the Apache 2.4 webserver, so install Apache on your CentOS 7 using the following yum command:

## yum install httpd openssl mod_ssl

Once installed, restart Apache and add it to automatically start on your system start-up using:

## systemctl restart httpd
## systemctl status httpd
## systemctl enable httpd

Now let’s configure some extra Apache options, for example, hide its version number, its banner etc… by adding the following to /etc/httpd/conf.d/options.conf

## vim /etc/httpd/conf.d/options.conf

TraceEnable off

## Disable Signature
ServerSignature Off

## Disable Banner
ServerTokens Prod

Test Apache configuration file and restart the webserver for the changes to take effect:

## apachectl configtest
## systemctl restart httpd
## systemctl status httpd

 

INSTALL PHP

Since DokuWiki relies on PHP, we have to add PHP support to the Apache webserver by installing the following packages:

## yum install php php-gd

Although DokuWiki operates with the default PHP settings, it is recommended to tune your PHP configuration (php.ini). At least you should edit your /etc/php.ini and set the following:

## vim /etc/php.ini

expose_php = Off

restart Apache using systemctl for the changes to take effect:

## systemctl restart httpd
## systemctl status httpd

Test if PHP module is loaded in Apache using:

## httpd -M | grep php

also

## php -v

 

SET-UP APACHE VHOST

We’ll use wiki.mydomain.com to access the DokuWiki installation, so we would have to create an Apache Virtual Host directive. So, create /etc/httpd/conf.d/vhosts.conf and add the following:

## cat /etc/httpd/conf.d/vhosts.conf

# Load my vhosts
IncludeOptional vhosts.d/*.conf

This tells Apache, to load the configuration files ending with .conf which reside in /etc/httpd/vhosts.d. As you can guess, this is the place where we put the Virtual Hosts, so let’s set-up one for wiki.mydomain.com

VHOST for wiki.mydomain.com
## mkdir /etc/httpd/vhosts.d
## vim /etc/httpd/vhosts.d/wiki.mydomain.com.conf

<VirtualHost YOUR_SERVER_IP:80>
    ServerAdmin webmaster@mydomain.com
    DocumentRoot "/var/www/html/dokuwiki"
    ServerName wiki.mydomain.com
    ServerAlias www.wiki.mydomain.com
    ErrorLog "/var/log/httpd/wiki.mydomain.com-error_log"
    CustomLog "/var/log/httpd/wiki.mydomain.com-access_log" combined

    <Directory "/var/www/html/dokuwiki/">
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

restart apache for the changes to take effect:

## systemctl restart httpd
## systemctl status httpd

 

INSTALL DOKUWIKI

First thing to do is to go to DokuWiki’s download page and download the latest stable version of DokuWiki.

## wget -P /tmp http://download.dokuwiki.org/out/dokuwiki-de8b19be26a1d74ba5bd5e075dbb7996.tgz

once the archive is downloaded, extract it to /var/www/html using:

## tar zxf /tmp/dokuwiki-de8b19be26a1d74ba5bd5e075dbb7996.tgz -C /var/www/html

set-up proper ownership using the chown command:

## chown apache: -R /var/www/html/dokuwiki

and open http://wiki.mydomain.com/install.php in your favorite browser to initiate the DokuWiki installer. You should get something like this:

dokuwiki_installer

once you complete the installer, you can safely remove the install.php script located withing your DokuWiki document root in /var/www/html/dokuwiki

## rm -f /var/www/html/dokuwiki/install.php

 

WHAT IS NEXT?

Now you have your DokuWiki up and running, so you may want to check its manual at https://www.dokuwiki.org/manual and also learn more about its syntax at https://www.dokuwiki.org/wiki:syntax


LET US DO THIS FOR YOU?

Of course you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert Linux admins to install Apache and DokuWiki. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

3 thoughts on “Install and run DokuWiki the most versatile Wiki on a CentOS 7 VPS”

  1. Hello,

    I used these instructions, now I am having permission issues :(

    DokuWiki Setup Error

    The datadir (‘pages’) at ./data/pages is not found, isn’t accessible or writable. You should check your config and permission settings. Or maybe you want to run the installer?

    Reply

Leave a Comment