Troubleshooting configuration problems

Here is an explanation of some common problems with Apache2 configuration.

Rewrite module not enabled

If you have not enabled Apache2's Rewrite module, you will see this error when starting Apache2:

linux:/etc/apache2/vhosts.d # sudo /etc/init.d/apache2 restartSyntax error on line 28 of /etc/apache2/vhosts.d/koha-httpd.conf:
Invalid command 'RewriteEngine', perhaps misspelled or defined by amodule not included in the server configuration

Incorrect or missing Directory directive

On distributions such as openSuSE, if you have not added the Directory directive, you will see this error when you try to access Koha's OPAC or the staff client. This means Apache2 does not have permission to access Koha's folders.

Unable ...

Get Koha 3 Library Management System now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.