DokuWiki

It's better when it's simple

User Tools

Site Tools


Sidebar

Translations of this page?:

Learn about DokuWiki

Advanced Use

Corporate Use

Our Community


Follow us on Facebook, Twitter and other social networks.

install:centos

CentOS

CentOS 7.x with firewallcmd

Firewall Rules

Incoming traffic on port 80 may be blocked by default. If so, we must create a permanent firewall rule to accept incoming traffic to our DokuWiki website.

sudo firewall-cmd --permanent --zone=public --add-service=http 
sudo firewall-cmd --reload	 

Apache

Ensure apache service always starts on boot.

sudo systemctl enable httpd.service  

mod_rewrite must be enabled so the .htaccess file which locks down the /data directory can be executed.

mod_rewrite is enabled by default on CentOS 7.x, if you need to re-enable it add the following line to a new .conf file and restart apache to load the mod_rewrite module

echo LoadModule rewrite_module modules/mod_rewrite.so > /etc/httpd/conf.d/addModule-mod_rewrite.conf
sudo systemctl restart httpd.service

PHP GD Module Install

The PHP GD module must be installed for image resizing.

sudo yum install php-gd

SELinux Note

CentOS comes with SELinux enabled by default which prevents the apache user from writing to the Document Root and sub directories.

Option 1 Switch SELinux to permissive mode, only for the httpd(Apache) service. This will leave SELinux enforcing for the rest of the system. This is the easier solution, but arguably also the less safe, as SELinux does not provide any protection for httpd.

sudo yum install policycoreutils-python
sudo semanage permissive -a httpd_t

Option 2 Modify SELinux context (conf & data directories)

sudo chcon -Rv --type=httpd_sys_rw_content_t /var/www/html/dokuwiki/conf
sudo chcon -Rv --type=httpd_sys_rw_content_t /var/www/html/dokuwiki/data
sudo semanage fcontext -a -t httpd_sys_rw_content_t /var/www/html/dokuwiki/conf (Try adding -h option if it doesn't work)
sudo semanage fcontext -a -t httpd_sys_rw_content_t /var/www/html/dokuwiki/data
sudo restorecon -v /var/www/html/dokuwiki/conf
sudo restorecon -v /var/www/html/dokuwiki/data

For option 2: Using the Wiki Upgrade Plugin & the Extension Manager
To use the Wiki Upgrade Plugin & the Extension Manager with option 2 you also have to grant apache access to the network, otherwise you will get the error : Could not connect Permission denied

sudo setsebool -P httpd_can_network_connect on

check with getsebool -a | grep httpd_can_network_connect

Troubleshooting:

If a HTTP 500 error code is returned, maybe the SELinux context of the files in the /var/www/dokuwiki directory is incorrect. The required context appears to be “httpd_sys_content_t”

install/centos.txt · Last modified: 2017-10-03 08:25 by 2601:3c6:4200:8906:6cda:63f9:b57b:6467