The big advantage of using Debian for a DokuWiki install is that this distro has a simplified install process over other distributions, as both the installation and the upgrade of the software are completely handled by Debian’s package manager.
In additon to this, there is an advantage by using DokuWiki over some other heavier wiki software such as, for example, MediaWiki: it is structurally simple. Everything, from configuration files to pages content, lies in simple text files. That’s right, no need for a database or anything else, just a simple folder and file structure. This also makes it very easy to update, restore and migrate DokuWiki installs should you need to.
Therefore, if you need a wiki up and running quickly, these are the instructions on how to install DokuWiki on Debian 8.
- Download the Debian Image. For this, I have used the netinst image of Debian 8, which you can find here (at the time of writing it’s on version 8.3.0). Just select the appropriate architecture (amd64 in my case) and proceed with the download.
- Install Debian. When you reach the tasksel section, deselect all metapackages (we want to keep the installation light, as everything can be than managed from a browser anyway).
- After the installation is complete, login with the user you created during the installation process.
- Acquire root privileges by typing
- Assign a static IP to this machine by editing
nano nano /etc/network/interfaces. This is an example configuration file:
auto eth0 iface eth0 inet static address 192.168.0.50 netmask 255.255.255.0 gateway 192.168.0.1
- Configure the DNS servers by editing
/etc/resolv.conf. You can list as many as you want here, like this:
nameserver 192.168.0.254 nameserver 192.168.0.1
- Restart the networking service to apply the changes:
- Now update your distribution to make sure you download the latest version of DokuWiki later on:
- If you want to manage this machine remotely, install the SSH server service:
apt-get install openssh-server(SSH is not included in the default Debian installation if all metapackages are deselected during install)
- You can now install DokuWiki with
apt-get install dokuwiki
- After the installation is complete, you can now proceed configuring the software: run
- In my case I have used Apache 2.4 as web server, but you can select other servers if you want
- Leave the document root unchanged:
local networkfor the authorized network
- Enter your local network in CIDR format when prompted for network information (in my case:
- When prompted to “Purge pages on package removal”, select Yes
- When prompted to “Make the configuration folder web-writeable”, select Yes
- When prompted to “Make the plugins directory web-writeable”, select Yes
- Enter the wiki title
- Select the license
- When prompted to “Enable ACL”, select Yes
- You can now access your wiki from a browser by going to this address: $IP_address_you_configure/dokuwiki
Note: the default administrator user in a DokuWiki install is
There you go, you now have a wiki up and running with minimal effort. Becoming familiar with the wiki syntax will take some time, but if you are already familiar with writing in markup it shouldn’t take long. The documentation is also pretty good should you run into any issues.
I am also thinking about scripting this install, let me know in the comments below if you would find this useful (and, of course, if you have any questions about the post). Cheers!