User Tools

Site Tools


Documentation in a changing environment

When an easy to use textual documentation system is needed, with the option to make several namespaces (for example, each department its own) and have the option to secure them, Dokuwiki is a good choice. Dokuwiki contains a LDAP-module for user authentication. More details on Dokuwiki are available on the Dokuwiki website.


All textual data is placed in the wiki. Updates and additions can be easily made. For convenience, images can be added.


Dokuwiki is a web based application that is written in PHP. So you'll need a webserver that supports PHP. You might want a LDAP-server for user authentication.

You're strongly advised to read the Dokuwiki Security page before you start the installation process!


Although a prebuild Dokuwiki package is available for Debian Etch, we prefer to get the latest version of the stable source code ourselves. If you want to use the prebuild package instead, read the Debian installation page on the Dokuwiki website.

You can download the Dokuwiki software at Unpack the source in /var/www and create a symbolic link for convenience.

cd /var/www/
tar -zxvf /root/dokuwiki-2007-06-26b.tgz
ln -s dokuwiki-2007-06-26b dokuwiki

Set the permissions as documented at

Now point your browser to http://yourwebserver/dokuwiki/install.php and follow the instructions.


Create several namespaces. Secure each namespace with an appropriate group. Put your users in the groups of the namespaces they need to read or edit.

LDAP authentication

Fedora Directory Server

Edit conf/local.php

$conf['title'] = 'wiki-hannibal';
$conf['lang'] = 'en';
$conf['useacl'] = 1;
$conf['openregister'] = 0;
$conf['authtype'] = 'ldap';
$conf['auth']['ldap']['server'] = 'ldap://';
$conf['auth']['ldap']['usertree'] = 'ou=People,dc=intra,dc=example,dc=com';
$conf['auth']['ldap']['grouptree'] = 'ou=Groups,dc=intra,dc=example,dc=com';
$conf['auth']['ldap']['userfilter'] = '(&(uid=%{user})(objectClass=posixAccount))';
$conf['auth']['ldap']['groupfilter'] = '(&(objectClass=posixGroup)(memberUID=%{uid}))';
$conf['auth']['ldap']['version'] = 3;
$conf['superuser'] = '@wikiadmins'; 
Microsoft Active Directory server

Although strictly not a (supported) part of the Hannibal system-stack, this conf/local.php snipplet might allow you to authenticate against the Microsoft Active Directory server LDAP implementation:

$conf['youarehere'] = 1;
$conf['useacl'] = 1;
$conf['authtype'] = 'ldap';
$conf['superuser'] = '@wikiadmins';
$conf['disableactions'] = 'register';
$conf['updatecheck'] = 0;
$conf['openregister'] = '0';
$conf['auth']['ldap']['server'] = '';
$conf['auth']['ldap']['binddn'] = '%{user}@%{server}';
$conf['auth']['ldap']['usertree'] = 'dc=intra,dc=example,dc=com';
$conf['auth']['ldap']['userfilter'] = '(userPrincipalName=%{user}@%{server})';
$conf['auth']['ldap']['mapping']['name'] = 'displayname';
$conf['auth']['ldap']['mapping']['grps'] = 'array(\'memberof\' => \'/CN=(.+?),/i\')';
$conf['auth']['ldap']['grouptree'] = 'dc=intra,dc=example,dc=com';
$conf['auth']['ldap']['groupfilter'] = '(&(cn=*)(Member=%{dn})(objectClass=group))';
$conf['auth']['ldap']['referrals'] = '0';
$conf['auth']['ldap']['version'] = '3';


Static documentation from internal or external sources does not fit well in a wiki. However, web based accessibility of this data might be very useful. In addition to Dokuwiki you could deploy a fileserver based on the webDAV-protocol as a solution.

hannibal/wikiserver.txt · Last modified: 2008/06/26 07:43 by Olivier Brugman