Dokuwiki

From NixOS Wiki
Revision as of 13:50, 2 August 2022 by imported>Onny

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

/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

/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

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