It's better when it's simple

User Tools

Site Tools


Installation DokuWiki under Ubuntu

Please note The repository of Ubuntu has still the 2018-04-22 version of DokuWiki. This version is not recommended. Please install the newest version of DokuWiki. The instruction below uses a version downloaded directly from

Ubuntu 14.04, and 16.04?

These are instructions on how to install a single DokuWiki under Ubuntu 14.04. Other version installations are discussed below. If you want to install a DokuWiki Farm, follow these instructions and then visit the Farm Page.

Please note that there is a dokuwiki package in the Ubuntu repositories. If you want to use it, please see the Debian install page instead. This article describes the installation of DokuWiki from a tarball. (The Ubuntu and Debian packages follow the Debian directory conventions and that is why different steps are needed when using the Ubuntu/Debian package).

:!: For Ubuntu 16.04 you will want to use libapache2-mod-php7.0 and make sure to install php7.0-xml, php7.0 with apt-get

Upgrading from Ubuntu 14.04 LTS to Ubuntu 16.04 LTS I had to add the following:

  • apt-get install php7.0
  • apt-get install php-mbstring
  • apt-get install php7.0-xml

This resolved all the issues restoring DokuWiki back to normal prior to the upgrades.

  1. Install Ubuntu Server 14.04 Step by step instructions with screenshots
  2. Update & Upgrade Ubuntu.
    sudo apt-get update && sudo apt-get upgrade
  3. Install Apache2 and PHP.
    sudo apt-get install apache2 libapache2-mod-php php-xml
  4. Enable Apache Rewrite module.
    sudo a2enmod rewrite
  5. Download and uncompress the latest stable release.
    cd /var/www
    sudo wget
    sudo tar xvf dokuwiki-stable.tgz
    sudo mv dokuwiki-*/ dokuwiki
  6. Change permissions.
    sudo chown -R www-data:www-data /var/www/dokuwiki
  7. Change document root in Apache to point to /var/www/dokuwiki
    sudo nano /etc/apache2/sites-enabled/000*.conf

    DocumentRoot /var/www/html
    DocumentRoot /var/www/dokuwiki

    1. If you want to host a DokuWiki server on localhost for testing purposes do NOT change the content of /etc/apache2/sites-enabled/000*.conf, instead create a new file in
      sudo touch apache2-dokuwiki.conf

      with the following content:

              DocumentRoot /var/www/dokuwiki
       	ServerName localhost
    2. enable the new project by placing it into /etc/apache2/sites-enabled with
      sudo a2ensite apache2-dokuwiki
    3. and then reload apache2 service
      sudo service apache2 reload
  8. Change AllowOverrides setting in Apache2 to use .htaccess files for security.
    sudo nano /etc/apache2/apache2.conf
    1. For directory /var/www/ replace
      AllowOverride None
      AllowOverride All
  9. Restart Apache2 service.
    sudo service apache2 restart
  10. Visit http://IP-address-of-your-server/install.php to initially configure your DokuWiki.
    1. If you decided to host DokuWiki on localhost for testing purposes from point 7a-c, visit
  11. Delete the install.php file after finished installing.
    sudo rm /var/www/dokuwiki/install.php
  12. Needed for sending email (e.g. user registration): install sendmail program, e.g. postfix
    sudo apt-get install postfix

    and configure appropriately

  13. Enjoy your own DokuWiki server.

Additional Installation Information

For more information on installing and configuring DokuWiki on Ubuntu, see debian_ubuntu_extras.

Apache configuration for running DokuWiki in ~/public_html

This works with Ubuntu 11.04 natty:

  1. Install apache2 and the php5 module:
    sudo apt-get install apache2 libapache2-mod-php5
  2. Enable the userdir and rewrite modules:
    sudo a2enmod userdir
    sudo a2enmod rewrite
  3. To make your .htaccess work, edit /etc/apache2/mods-enabled/userdir.conf and change the AllowOverride directive to All1)
  4. By default, php is disabled for user directories. To enable it, comment the lines as per instruction in /etc/apache2/mods-enabled/php5.conf
  5. Restart apache with
    sudo service apache2 restart

Ubuntu Server 14.04 and lighttpd

  1. Install lighttpd and php.
    sudo apt-get install lighttpd 
    sudo apt-get install php5-cgi 
  2. Download dokuwiki, and place in www directory. Change file name appropriately as your downloaded file is placed and named.
    tar xvfz dokuwiki.tgz 
    ls -l
    sudo cp -r dokuwiki/ /var/www/
    sudo chown -R www-data:www-data /var/www/dokuwiki
  3. Configure lighttpd for php.
    sudo lighttpd-enable-mod fastcgi-php
    sudo /etc/init.d/lighttpd force-reload
  4. That's it. Enjoy your own DokuWiki server. (Test if it works on your http://localhost/dokuwiki)

Installation of DokuWiki using apt-get

apt list dokuwiki

Check the date, if the date is over a couple months then I would highly recommend stopping here and trying the above methods for installation.

dokuwiki/eoan,now 0.0.20180422.a-2 all [residual-config]

If you insist on using the above package then the steps below will assist getting your installation operational.


  1. As of 2020-01-02 the package is dated 2018-04-22 which is quite out of date.
  2. I am concerned that:
    1. more items in /var/lib/dokuwiki/ might be required in /usr/share/dokuwiki
    2. more items in /etc/dokuwiki/ might be required in /usr/share/dokuwiki
  3. Initially there are a number of PHP warnings that appear to pop up occasionally when first exploring the wiki, however they seem to go away and not return (often). These issues are documented on the DokuWiki web site, and claim to be fixed, likely the issues will go away after the DokuWiki install package gets updated.

Assuming that you have already installed apache and PHP (see above) and they are operating correctly.

The following commands will require sudo prefix or require you to be su (naughty).

sudo apt install dokuwiki

Folders of interest

  • /etc/dokuwiki/
  • /usr/share/dokuwiki/
  • /var/lib/dokuwiki/

The apt package has number of problems which you will need to address:

chown www-data:www-data /usr/share/dokuwiki
chown www-data:www-data /usr/share/dokuwiki/* -R
chown www-data:www-data /var/lib/dokuwiki
chown www-data:www-data /var/lib/dokuwiki/* -R
ln -s /var/lib/dokuwiki/data /usr/share/dokuwiki/data
ln -s /etc/dokuwiki/license.php /usr/share/dokuwiki/conf/license.php

Create virtual directory for apache

nano /etc/apache2/sites-available/dokuwiki.conf
Alias /dokuwiki /usr/share/dokuwiki
<Directory /usr/share/dokuwiki>
        Options +FollowSymLinks
        AllowOverride All
        DirectoryIndex index.php
        Order allow,deny
        Allow from all
AliasMatch ^/dokuwiki/sites/[^/]+$      /usr/share/dokuwiki/
AliasMatch ^/dokuwiki/sites/[^/]+/(.*)$ /usr/share/dokuwiki/$1

Tell apache to enable the virtual folder (Note: use a2dissite to disable).

a2ensite dokuwiki
systemctl reload apache2

Open your web browser and configure DokuWiki (You will likely get warnings if you have PHP 7.x).
FIXME: someone with more apache savvy than me can probably suggest a “safer” setting for AllowOverride
install/ubuntu.txt · Last modified: 2024-01-19 15:49 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki