Install and Setup DokuWiki on Ubuntu 20.04

Last Updated:

In this demo, we are going to learn how to install and setup DokuWiki on ubuntu 20.04 server. DokuWiki is an opensource software written in PHP that allows users to create and edit pages using a web browser. It works on plain texts and requires no database.

DokuWiki is feature rich. Read about the features on DokuWiki features page.

Install and Setup DokuWiki on Ubuntu 20.04

Run system update

Update and upgrade your system packages;

apt update
apt upgrade

Next, run system reboot;

Note: In order to determine whether to reboot the system after the upgrade or what services need restart, just install the needrestart package, apt install needrestart. Once you install it, just run needrestart from terminal.

systemctl reboot

Install PHP and Required PHP Modules

DokuWiki is a PHP based web application. It requires PHP and some PHP extensions installed in order to function correctly. To install PHP and the required modules for DokuWiki, run the command below;

apt install php php-gd php-xml php-json

Install Apache Web Server

Apache is used as web server for DokuWiki in this demo. When PHP is installed, it installs Apache as one of its required package dependency. To confirm this use the list option of apt command;

apt list apache2
apache2/focal,now 2.4.41-4ubuntu3 amd64 [installed,automatic]

Assuming that for some weird reasons Apache is not installed with PHP, run the command below to install it.

apt install apache2

Start and enable Apache to run on system boot.

systemctl enable --now apache2

Open Apache Port on Firewall

To allow external access to your DokuWiki, you need to open Apache port on firewall (UFW) if at all it is running. The port to open depends on the traffic being server, which in this case is just basic HTTP (port 80).

ufw allow 80/tcp

or simply;

ufw allow Apache

Install DokuWiki on Ubuntu 20.04

DokuWiki is distributed as a ready to run application. All you need to do is download the distribution tarball and extract it to your web root directory;

Download the latest release version from DokuWiki download’s page. You can simply run the command below to get it;


 Unpack DokuWiki Tarball to your web root directory, /var/www/html/dokuwiki, in our case;

mkdir /var/www/html/dokuwiki
tar xzf dokuwiki-stable.tgz -C /var/www/html/dokuwiki/ --strip-components=1

This will extract the application files on to our web root directory, /var/www/html/dokuwiki/.

ls /var/www/html/dokuwiki
bin conf COPYING data doku.php feed.php inc index.php install.php lib README vendor VERSION

Create Apache VirtualHost for DokuWiki

To create a VirtualHost config file for DokuWiki, simply proceed as follows making the relevant changes as per your environment setup.

vi /etc/apache2/sites-available/dokuwiki.conf
<VirtualHost *:80>
        DocumentRoot  /var/www/html/dokuwiki

        <Directory ~ "/var/www/html/dokuwiki/(bin/|conf/|data/|inc/)">
            <IfModule mod_authz_core.c>
                AllowOverride All
                Require all denied
            <IfModule !mod_authz_core.c>
                Order allow,deny
                Deny from all

        ErrorLog   /var/log/apache2/dokuwiki_error.log
        CustomLog  /var/log/apache2/dokuwiki_access.log combined

Save and exit the configuration file.

The use of AllowOverride All allows the use of .htaccess files. As such, rename the DokuWiki .htaccess file as shown below;

cp /var/www/html/dokuwiki/.htaccess{.dist,}

Set the ownership of the DokuWiki web root directory to www-data.

chown -R www-data:www-data /var/www/html/dokuwiki

Check Apache for any syntax errors;

apache2ctl -t

If you get the Syntax OK output, then you good. Otherwise, fix any error.

Syntax OK

Disable the default Apache test site;

a2dissite 000-default.conf

Enable the DokuWiki site;

a2ensite dokuwiki.conf

Reload Apache;

systemctl reload apache2

Complete DokuWiki Setup on Ubuntu 20.04

To complete the setup, access your DokuWiki from the browser, http://<server-IP-or-hostname>/install.php.

Install and Setup DokuWiki on Ubuntu 20.04

Set the name of the wiki, enable the ACL and other settings. Save the configurations and continue to your DokuWiki.

Install and Setup DokuWiki on Ubuntu 20.04

To login to your DokuWiki, click Log in at the top right corner.

Install and Setup DokuWiki on Ubuntu 20.04

To make further configurations after login, click Admin gear icon at the top right corner.

Install and Setup DokuWiki on Ubuntu 20.04

Beautiful. That is how easy it is to install and setup DokuWiki on Ubuntu 20.04. Explore the tool further and make your own tweaks. Enjoy.


Install [DokuWiki]

Other Tutorials

How to Configure DokuWiki OpenLDAP Authentication

Install DokuWiki on CentOS 8

Install and Setup OpenVPN Server on Ubuntu 20.04

Install ELK Stack on Ubuntu 20.04


We're passionate about sharing our knowledge and experiences with you through our blog. If you appreciate our efforts, consider buying us a virtual coffee. Your support keeps us motivated and enables us to continually improve, ensuring that we can provide you with the best content possible. Thank you for being a coffee-fueled champion of our work!

Photo of author
Co-founder of, Linux Tips and Tutorials. Linux/Unix admin and author at

2 thoughts on “Install and Setup DokuWiki on Ubuntu 20.04”

  1. This page saved my (second) day, and was the only working way for the setup of an local dokuwiki, after ten hours of struggling with the apache configuration, outdated howtos full of deadlinks, and other error-after-error nightmares!

    Thank You!


Leave a Comment