DokuWiki

It's better when it's simple

User Tools

Site Tools


install:fedora

This is an old revision of the document!


Fedora Package

These instructions are written for Fedora, there may be differences for other versions.

DokuWiki is available in the Fedora repositories. So

yum install dokuwiki dokuwiki-selinux

The package dokuwiki-selinux does configure SELinux to allow dokuwiki to write to its configuration. Its necessary for the Configuration Manager of DokuWiki to work.

Package details are available at https://admin.fedoraproject.org/pkgdb/acls/name/dokuwiki

httpd

Apache, named httpd in Fedora, is not enabled by default.

You may start it with

systemctl start httpd.service

And you may enable it for automatic startup at system boot with

systemctl enable httpd.service

To disable or to stop httpd, just use the commands “disable” and “stop”.

DokuWiki should be accessible at http://localhost/dokuwiki now.

Configuration

The basic configuration just lets you create and edit pages, but doesn't allow you to login and use the Configuration Manager.

The configuration resides in /etc/dokuwiki. local.php contains your local configuration, dokuwiki.php contains dokuwikis defaults and should be left alone. The Configuration Manager also writes to local.php.

To enable login, edit local.php and set

$conf['useacl'] = 1;
$conf['superuser'] = '@admin';

This enables ACL (Access Control) and gives all members of the group “admin” superuser rights.

Now add a new user to users.auth.php

admin:21232f297a57a5a743894a0e4a801fc3:Admin:example@example.com:admin

The user is named “admin” with password “admin” and is member of the group “admin”, which has superuser rights.

You can now login as user “admin” and use DokuWikis admin tools to configure it, to add new users and the like.

Paths

DokuWiki /usr/share/dokuwiki
Configuration /etc/dokuwiki
Data directory /var/lib/dokuwiki/data

Allowing access

Once this is installed, you should be able to access this on your local machine. A problem may arise when you try to access it through a network. This has to do with the config settings of Dokuwiki, to change them, Navigate to /etc/httpd/conf.d/ and there should be a file named dokuwiki.conf.

  • For Fedora versions earlier than 18 (Apache 2.2): Edit the file and find the line that says “Allow 127.0.0.1 only” and change it to say “Allow from All”.
  • For Fedora 18 and later (Apache 2.4): Edit the file and find the line that says “Require local” and change it to say “Require all granted”.

Save the file and restart the Apache server

systemctl restart httpd.service

It should now allow remote requests to the site. Depending on your setup, you may have to allow incomming http(s) traffic in you firewall though.

install/fedora.1375703886.txt.gz · Last modified: 2013-08-05 13:58 by gajda

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki