It's better when it's simple

User Tools

Site Tools


Translations of this page?:

Learn about DokuWiki

Advanced Use

Corporate Use

Our Community

Follow us on Facebook, Twitter and other social networks.


Installation DokuWiki under Ubuntu

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)
FIXME: someone with more apache savvy than me can probably suggest a “safer” setting for AllowOverride
install/ubuntu.txt · Last modified: 2017-12-28 17:55 by Aleksandr