• Return to KohaManual
• SampleData: Example data for playing with new install

Example /etc/koha.conf file entries

database=Koha
hostname=localhost
user=Koha
pass=xxxxxx
includes=/usr/local/www/koha/htdocs/includes

Please note the final line (includes=path) - The path entry can be used as an alternative to manually editing the path in Output.pm file (see INSTALL manual).

Example apache httpd.conf entries Koha makes extensive use of Server Side Includes (SSI):

: http://httpd.apache.org/docs/mod/mod_include.html If your page headers and footers do not show, then you may need to re-configure your web server.

Here is an example of entries suitable for Apache httpd.conf:

<VirtualHost 111.222.333.1>
   ServerName koha.example.com
   ServerPath /var/www/library
   DocumentRoot /var/www/library/koha/html
   Alias /images/ "/var/www/library/koha/html/images/"
   ScriptAlias  /cgi-bin/koha/ "/var/www/library/koha/cgi-bin/"
   SetEnv PERL5LIB "/var/www/library/modules"
   ErrorLog /var/log/httpd/koha-error_log
   # 
   # ======== koha uses Server Side Includes =========
   # Normally here, use the same path as "DocRoot" above
   <Directory "/var/www/library/koha/html">
        #       
        AllowOverride None
        #
        # First, you MUST enable +Includes or +IncludesNoExec
	#
        Options +Includes -FollowSymlinks -Indexes
        #
        # Second, you must also configure one of following:
	#
        # 1. server-parsed content (SSI) for files ending in ".html"
	#
        AddHandler server-parsed .html
        #
            # ...OR... (not "AND" !!!!)...
            #
            # 2. Allow SSI if executable bit set using "XBitHack"
            # XBitHack on|off|full
            #
            # XBitHack on - any file that has the user-execute bit
            # - set will be treated as a server-parsed html doc. 
            # - The "full" = "on" but, in addition, will test the
            # - group-execute bit. If the group execute bit is set
            # - then the Last-modified date of the returned file
            # - is sent. If group-execute bit is not set, then no
            # - last-modified date is sent.
	    # - Setting this bit allows clients and proxies to
	    # - cache the result of the request!
            #
            # For example, enable XBitHack (on) if you want to
            # - include non-executable content in documents like:
            #   <!--#include virtual="/includes/footer.inc" -->
            #   <!--#include virtual="/cgi-bin/counter.pl" -->
            #
            # XBitHack on
            #
            # Remember - do not use XBitHack if using AddHandler!
    </Directory>    
</VirtualHost>

<VirtualHost 111.222.333.1>
    ServerName opac.example.com
    ServerPath /var/www/library
    DocumentRoot /var/www/library/opac/html
    Alias /images/ "/var/www/library/opac/html/images/"
    ScriptAlias  /cgi-bin/opac/ "/var/www/library/opac/cgi-bin/"
    SetEnv PERL5LIB "/var/www/library/modules"
    ErrorLog /var/log/httpd/opac-error_log
    #
    <Directory "/var/www/library/opac/html">
            AllowOverride None
            Options +Includes -FollowSymLinks -Indexes
	    AddHandler server-parsed .html
    </Directory>
</VirtualHost>

Read your web server docs for more information about how Server Side Includes work.

Return to KohaManual