Dokuwiki

From NixOS Wiki
Revision as of 13:50, 2 August 2022 by Onny (talk | contribs)
Jump to: navigation, search

DokuWiki is a web application and simple Wiki software for creating documentation and editable pages in markdown language. Compared to other Wikis, it is more minimal and only depends on PHP and file access without any need for databases.

Installation

To setup DokuWiki locally, this is the most minimal configuration to get started

Breeze-text-x-plain.png
/etc/nixos/configuration.nix
services.dokuwiki.sites."localhost" = {
  enable = true;
  extraConfig = ''
    $conf['title'] = 'My Wiki';
  '';
};


After that DokuWiki will be available at http://localhost .

Configuration

Users and permissions

To disable the user permissions completely and make the Wiki editable by anyone (even anonymous users), you can use following configuration

Breeze-text-x-plain.png
/etc/nixos/configuration.nix
services.dokuwiki.sites."localhost" = {
  aclUse = false;
  extraConfig = ''
    $conf['userewrite'] = 1;
  '';
};


Tips and tricks

SSL behind reverse proxy

In case you're running DokuWiki behind a reverse proxy which offers ssl/https to the outside, you might have to enforce https protocol by changing the baseurl

Breeze-text-x-plain.png
/etc/nixos/configuration.nix
services.dokuwiki.sites."localhost".extraConfig = ''
  $conf['baseurl'] = 'https://wiki.project-insanity.org';
'';
};