Dokuwiki

This is an ansible role which sets up a dokuwiki instance and configures the wiki and the ldap authentication for the users.

Requirements

This role needs an apt based packager manager.

Role Variables

If you set useacl to 1 you can place a acl.auth.php in the hosts file folder in your repository it will be copied over. Same is if you set dokuwiki_custom_logo to true, then you can place a logo.png in the file folder and it will be copied. To see all vars possible for dokuwiki see dokuwiki config page

There are no mandatory variables for this role. It will be a generic dokuwiki without specified variables though.

Name	Required	Default	Description
dokuwiki_install_path	✖️		Install path of dokuwiki
dokuwiki_public_namespace_name	✖️		Name of the public namespace to be created
dokuwiki_acls	✖️		Required if dokuwiki_useacls is set. List of dict acl objects
dokuwiki_custom_logo	✖️		Name of png file to be used as logo

Acl object

Permission informationen can be found below under Acl Permission

Name	Required	Default	Description
namespace	✔️		Namespace where the permissions should be applied
group	✔️		Group for the acl
permission	✔️		Permission value for the acl.

Acl Permission

Name	Permission value
None	0
Read	1
Edit	2
Create	4
Upload	8
Delete	16

Dependencies

This role needs the php-fpm and nginx role installed on the host to function with the variables from the group_vars of dokuwiki.yml.

Playbook

- hosts: dokuwiki
  become: yes
  roles:
    - php-fpm
    - nginx
    - dokuwiki

Here it is speciefied that the roles php-fpm and nginx are to be played before dokuwiki is being played on the hosts that belong to dokuwiki.

Result

A running dokuwiki instance on the host.

License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Author Information

• Florian Greinert (sryneklar) [email protected]