=====Dokuwiki=====

> '''DokuWiki''' is a wiki application licensed under GPLv2 and written in the PHP programming language. It works on plain text files and thus does not need a database. Its syntax is similar to the one used by MediaWiki.

At the end of this guide you have Dokuwiki up and running on your own Debian-based server.

====Prerequisites====
  * A running Debian-based server.
  * Apache set up.

====Installation====

===Download===
Download Dokuwiki from its website to your home directory:

<code bash>
cd ~
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
</code>

Unzip the compressed file:
<code bash>
tar -xzf dokuwiki-stable.tgz
mv dokuwiki-*/ dokuwiki/
</code>

Put the dokuwiki directory in your /var/www/ directory:

<code bash>
sudo cp -af dokuwiki /var/www/
</code>

===Apache configuration===
Edit the Apache configuration file of the web address you want to use:

<code bash>
sudo nano /etc/apache2/sites-available/000www.example.com.conf
</code>

<code bash /etc/apache2/sites-available/000www.example.com.conf>
<VirtualHost *:80>
   ServerName www.example.com
   Redirect / https://www.example.com/
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
   ServerName www.example.com
   DocumentRoot /var/www/dokuwiki
   CustomLog /var/log/apache2/www.example.com-access.log combined
   ErrorLog /var/log/apache2/www.example.com-error.log
   SSLCertificateFile /etc/letsencrypt/live/www.example.com/fullchain.pem
   SSLCertificateKeyFile /etc/letsencrypt/live/www.example.com/privkey.pem
</VirtualHost>
</IfModule>

<Directory /var/www/dokuwiki>
  order deny,allow
  allow from all
</Directory>

<LocationMatch "/(data|conf|bin|inc)/">
  order allow,deny
  deny from all
  satisfy all
</LocationMatch>
</code>

Reload Apache:

<code bash>
sudo systemctl reload apache2
</code>

===Permissions===
Give ownership of the /var/www/dokuwiki folder to www-data:
<code bash>
cd /var/www/dokuwiki
sudo chown -R root:root .
sudo chmod -R 775 data/
sudo chown -R www-data:www-data data/
cd data
sudo chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp}
sudo chown www-data:www-data {attic,cache,index,locks,media,meta,pages,tmp}
cd ..
sudo chown -R www-data:www-data conf/
sudo chown www-data:www-data lib/plugins/ lib/tpl 
</code>

===Run the installer===
Run the installer on [[https://www.example.com/install.php|www.example.com/install.php]].

More information about the installer on [[https://www.dokuwiki.org/installer|dokuwiki.org/installer]]

Remove the installer file:
<code bash>sudo rm /var/www/dokuwiki/install.php</code>

Enjoy your own wiki on [[https://www.example.com|www.example.com]]!