Dokuwiki

From SME Server
Jump to: navigation, search

dokuwiki for SME Server

PythonIcon.png Skill level: easy
The instructions on this page can be followed by a beginner.

Maintainer

Daniel B. from Firewall Services

Description

DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database. It is loved by users for its clean and readable syntax. The ease of maintenance, backup and integration makes it an administrator's favorite. Built in access controls and authentication connectors make DokuWiki especially useful in the enterprise context and the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki.

Requirements

You need the firewall-services repo to install this contribs

Installation 8.x 9.x

This contrib is currently held in the fws repository, so the following commands will install on your smeserver.

yum install --enablerepo=fws smeserver-dokuwiki dokuwiki-plugins

You will then need to activate the database changes etc. The 'official' way is to perform

signal-event post-upgrade;  signal-event reboot

or if you do not want to restart your computer

signal-event webapps-update

There is no panel in the server-manager, you can go to https://sme-ip/dokuwiki and perform a login with users and passwords of your internal ldap.

Configuration

A few DB properties are available to control DokuWiki configuration:

  • AliasOnPrimary (enabled|disabled). Default is enabled. If disabled, the alias /dokuwiki will not be added in your main vhost in apache. This is only usefull if you want to create a dedicated vhost for DokuWiki
  • Authentication: can be either ldap, which is the default. With this setting, all the accounts on your SME Server will be used. Group membership is available to handle ACL. The admin user has full access to all option. Other valid values are internal, which will use the internal account in DokuWIki (you have to manually create accounts, or enable user registration in the configuration). The last value is 'LemonLDAP' which can be used to protect DokuWiki with [LemonLDAP-NG]. In this case, LemonLDAP::NG will handle authentication only, user information and group membership is looked up in LDAP, and authroization is handled by the DokuWiki ACL
  • access (public|private). Default is private, which means the wiki is only available from the internal networks (and IP allowed to access the server-manager). If set to public, the wiki will be available from anywhere
  • status (enabled|disabled). If set to disabled, the wiki won't be available anymore

Backup and restore

You should backup /etc/dokuwiki and /var/lib/dokuwiki (which store configuration and data respectivly)

Uninstall

yum remove smeserver-dokuwiki dokuwiki-plugins dokuwiki
signal-event post-upgrade;  signal-event reboot

Bugs

Sources for this contribs can be found in Firewall Service's repository [1]