Translation(s): English - Français - Italiano


DokuWiki

DokuWiki is available in the official Debian repository and is installable through the usual Debian tools.

Specificities of the Debian package

Contrary to a standard installation, the Debian package:

Some of these specificities come from the packaging system itself, some are to comply with the Debian policy. This has:

Specific problems

The full list of bugs filed against the Debian package can be found here. Here are the most important problems you may encounter:

Bugs reports

Please report bugs in the package using the Debian bug tracking system. See also the current list of bugs.

Installation

   sudo apt-get install dokuwiki

Configuration files are in /etc/dokuwiki/.

Data files are in /var/lib/dokuwiki/.

Your dokuwiki is available at: http://localhost/dokuwiki

Starting with Debian Lenny and Squeeze with #backports, it asks you some questions for the initial configuration:

All these questions do not have the same priority:

The package will only ask you the questions which priority is higher than the one that you chose globally to be bothered with; you can set this parameter by reconfiguring the package debconf: # dpkg-reconfigure debconf

For instance, if you chose to be bothered with high priority questions only, you will not be asked for all the DokuWiki package questions. You can still reconfigure the package dokuwiki itself to get all the questions: # dpkg-reconfigure dokuwiki

Backports

The package versions can be a bit outdated, specially if you are using an old Debian version such as Lenny (oldstable). Updated packages are available using the backports repository. For instance, for Lenny:

# echo "deb http://backports.debian.org/debian-backports lenny-backports main" >> /etc/apt/sources.list
# apt-get update
# aptitude install dokuwiki/lenny-backports

Usage

After installation of the package, your dokuwiki install is available at http://localhost/dokuwiki/ (replace //localhost// with the name or IP address of your server if it is not your local computer).

Starting with Debian Squeeze and Lenny #backports, your wiki is completely usable after installation, so start using it and skip the #Lenny section that is not for you. With Lenny without backports, the initial configuration is limited though, so read the next section.

Lenny

Please upgrade your system to Squeeze or use the package from the #backports! If you really do not want to do that, read on.

For a full access from the lan or from internet, edit the */etc/apache/conf/dokuwiki.conf* file and change *127.0.0.0* to *All* for Apache2: /etc/apache2/conf.d/dokuwiki.conf

You'll likely need to restart apache for this to take effect.

For a full config that includes login and adminstration from within the wiki you have to enable ACL and change some configs. You need root privileges to use the commands.

Configuration of multisite support (farm) with virtual hosts

This option is only available in version 0.0.20101107-4 or later. We'll show how to create two dokuwiki sites in a virtual host-based setup.

Virtual Hosts

Create two minimal virtual hosts (using apache server for this example):

/etc/apache2/sites-available/cat

<VirtualHost *:80>
   ServerName cat.yourdomain.tld
   DocumentRoot /usr/share/dokuwiki
</VirtualHost>

/etc/apache2/sites-available/dog

<VirtualHost *:80>
   ServerName dog.yourdomain.tld
   DocumentRoot /usr/share/dokuwiki
</VirtualHost>

Enable the sites:

sudo a2ensite cat dog

And reload your server

sudo service apache2 reload

Add more directives to your virtual hosts if necessary (omitted here to simplify the example). Look at /etc/dokuwiki/apache.conf for a more complete default configuration.

Create dokuwiki sites

To create a new site, you can use the command dokuwiki-addsite(1):

sudo dokuwiki-addsite cat.yourdomain.tld
sudo dokuwiki-addsite dog.yourdomain.tld

We have now two dokuwikis: one at http://cat.yourdomain.tld and the other one at http://dog.yourdomain.tld. They share the dokuwiki code, but have independent configurations and data.

Configuration files are in /etc/dokuwiki/farm/cat.yourdomain.tld and /etc/dokuwiki/farm/dog.yourdomain.tld.

Data files are in /var/lib/dokuwiki/farm/cat.yourdomain.tld and /var/lib/dokuwiki/farm/dog.yourdomain.tld.

Remove dokuwiki sites

sudo dokuwiki-delsite dog.yourdomain.tld

Questions and answers

Feel free to ask questions here:

? Where are data dirs?

(./) Under /var/lib/dokuwiki to comply with the Debian Policy and match the general system layout.

? Can you briefly list all steps necessary for multiple (separate) installations sharing the codebase?

(./) Implementing the farming within the Debian package is a mid-term goal, not achieved yet. Stay tuned.

? Can you install it on Ubuntu.

(./) Yes, because every package in Debian ends up in Ubuntu too. It is not directly maintained though, so things may break.

? How do I restore data from an older install on another machine?

(./) Copy /var/lib/dokuwiki/data from the old installation to the new one. Install the needed plugins manually.

? I installed using the Debian package, that would be the proper way to upgrade DokuWiki?

(./) Upgrade your system (from Lenny to Squeeze for instance) or use a #backport.

? I installed using the Debian package, but now (for whatever reason, e.g. access to latest release early) I want to go use the DokuWiki download installation (which is not Debian policy compatible)

(./) Get DokuWiki, install it following the regular instructions. Then restore your old content:

See also


CategoryProposedDeletion: This page largely duplicates http://www.dokuwiki.org/install:debian