1 # Koha Apache Configuration Directives
6 <VirtualHost __WEBSERVER_IP__:__WEBSERVER_PORT__>
7 ServerAdmin __WEBMASTER_EMAIL__
8 DocumentRoot __OPAC_WWW_DIR__
9 ServerName __WEBSERVER_HOST__
10 # ServerAlias opac.mydomain.com
11 ScriptAlias /cgi-bin/koha/ "__OPAC_CGI_DIR__/opac/"
12 ScriptAlias /index.html "__OPAC_CGI_DIR__/opac/opac-main.pl"
13 ScriptAlias /opac-search.pl "__OPAC_CGI_DIR__/opac/opac-search.pl"
14 ScriptAlias /search "__OPAC_CGI_DIR__/opac/opac-search.pl"
15 ErrorLog __LOG_DIR__/koha-opac-error_log
16 # CustomLog __LOG_DIR__/koha-opac-access.log combined
17 # TransferLog __LOG_DIR__/koha-opac-access.log
18 SetEnv KOHA_CONF "__KOHA_CONF_DIR__/koha-conf.xml"
19 SetEnv PERL5LIB "__PERL_MODULE_DIR__"
21 # This syntax allows you to override a system preference
22 # for a given virtual host. Use with caution!
23 # You should add all the system preferences you override
24 # in one or more vhosts to the environment variable
25 # OVERRIDE_SYSPREF_NAMES for your staff intranet vhost
26 # SetEnv OVERRIDE_SYSPREF_PrefName Value
28 <Directory "__OPAC_WWW_DIR__">
32 # Secure internal stuff
33 <DirectoryMatch "__OPAC_WWW_DIR__/.*/(modules|xslt|includes)">
41 mod_gzip_keep_workfiles No
42 mod_gzip_can_negotiate yes
43 mod_gzip_update_static No
44 mod_gzip_temp_dir /tmp
45 mod_gzip_minimum_file_size 512
46 mod_gzip_maximum_file_size 1000000
47 mod_gzip_maximum_inmem_size 1000000
48 mod_gzip_handle_methods GET POST
49 mod_gzip_item_exclude reqheader "User-Agent: .*Mozilla/4\..*\["
50 mod_gzip_item_exclude mime ^image/.*
51 mod_gzip_item_exclude rspheader Content-Type:image/*
52 mod_gzip_item_include file \.js$
53 mod_gzip_item_include mime ^application/javascript$
54 mod_gzip_item_include mime ^application/x-javascript$
55 mod_gzip_item_include file \.php$
56 mod_gzip_item_include mime ^text/html$
57 mod_gzip_item_include file \.css$
58 mod_gzip_item_include mime ^text/css$
61 <IfModule mod_deflate.c>
63 # Compress content with type html, text, and css, ...
64 AddOutputFilterByType DEFLATE text/plain text/html text/xml text/css
65 AddOutputFilterByType DEFLATE application/xml application/xhtml+xml application/rss+xml application/javascript application/x-javascript
67 DeflateCompressionLevel 9
69 # Properly handle old browsers that do not support compression
70 BrowserMatch ^Mozilla/4 gzip-only-text/html
71 BrowserMatch ^Mozilla/4\.0[678] no-gzip
72 BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
74 DeflateFilterNote Input instream
75 DeflateFilterNote Output outstream
76 DeflateFilterNote Ratio ratio
78 LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
79 <IfModule mod_headers.c>
80 #properly handle requests coming from behind proxies
81 Header append Vary User-Agent
86 # Repeat this virtualhost stanza changing the following environment vars to
87 # create multiple OPAC interfaces with custom css and/or search limits:
88 # SetEnv OPAC_CSS_OVERRIDE mystyle.css
89 # SetEnv OPAC_SEARCH_LIMIT branch:CODE
90 # SetEnv OPAC_LIMIT_OVERRIDE 1
92 Options +FollowSymLinks
94 ErrorDocument 400 /cgi-bin/koha/errors/400.pl
95 ErrorDocument 401 /cgi-bin/koha/errors/401.pl
96 ErrorDocument 403 /cgi-bin/koha/errors/403.pl
97 ErrorDocument 404 /cgi-bin/koha/errors/404.pl
98 ErrorDocument 500 /cgi-bin/koha/errors/500.pl
100 <IfModule mod_rewrite.c>
104 # Uncomment to turn on rewrite logging
105 #RewriteLog __LOG_DIR__/koha-opac-rewrite.log
108 #The following two directives are unnecessary to proper Koha functioning.
109 #RewriteCond %{QUERY_STRING} (.*?)(?:[A-Za-z0-9_-]+)=&(.*)
110 #RewriteRule (.+) $1?%1%2 [N,R,NE]
111 RewriteRule ^/bib/([^\/]*)/?$ /cgi-bin/koha/opac-detail\.pl?bib=$1 [PT]
112 RewriteRule ^/isbn/([^\/]*)/?$ /search?q=isbn:$1 [PT]
113 RewriteRule ^/issn/([^\/]*)/?$ /search?q=issn:$1 [PT]
114 RewriteRule ^(.*)_[0-9]{2}\.[0-9]{7}\.(js|css)$ $1.$2 [L]
116 # REST API configuration
117 Alias "/api" "__API_CGI_DIR__"
118 <Directory __API_CGI_DIR__>
119 Options +ExecCGI +FollowSymlinks
120 AddHandler cgi-script .pl
122 SetEnv MOJO_MODE "production"
126 RewriteCond %{REQUEST_FILENAME} !-f
127 RewriteCond %{REQUEST_FILENAME} !-d
128 RewriteCond %{DOCUMENT_ROOT}/../api/$1/app.pl -f
129 RewriteRule ^(.*?)/.* $1/app.pl/api/$0 [L]
133 <IfModule mod_expires.c>
135 ExpiresByType text/css "access plus 60 days"
136 ExpiresByType application/javascript "access plus 60 days"
137 ExpiresByType image/png "access plus 12 hours"
138 ExpiresByType image/gif "access plus 12 hours"
143 <VirtualHost __WEBSERVER_IP__:__WEBSERVER_PORT_LIBRARIAN__>
144 ServerAdmin __WEBMASTER_EMAIL__
145 DocumentRoot __INTRANET_WWW_DIR__
146 ServerName __WEBSERVER_HOST__:__WEBSERVER_PORT_LIBRARIAN__
147 # ServerAlias intranet.mydomain.com
148 ScriptAlias /cgi-bin/koha/ "__INTRANET_CGI_DIR__/"
149 ScriptAlias /index.html "__INTRANET_CGI_DIR__/mainpage.pl"
150 ScriptAlias /search "__INTRANET_CGI_DIR__/catalogue/search.pl"
151 Alias /plugin/ "__PLUGINS_DIR__/"
152 ErrorLog __LOG_DIR__/koha-error_log
153 # TransferLog __LOG_DIR__/koha-access.log
154 SetEnv KOHA_CONF "__KOHA_CONF_DIR__/koha-conf.xml"
155 SetEnv PERL5LIB "__PERL_MODULE_DIR__"
156 Options +FollowSymLinks
158 # If you are overriding any system preferences,
159 # list them in this variable so the preference editor
160 # knows that they have been overridden.
161 # SetEnv OVERRIDE_SYSPREF_NAMES "Pref1,Pref2,Pref3"
163 ErrorDocument 400 /cgi-bin/koha/errors/400.pl
164 ErrorDocument 401 /cgi-bin/koha/errors/401.pl
165 ErrorDocument 403 /cgi-bin/koha/errors/403.pl
166 ErrorDocument 404 /cgi-bin/koha/errors/404.pl
167 ErrorDocument 500 /cgi-bin/koha/errors/500.pl
169 <Directory "__INTRANET_WWW_DIR__">
173 # Secure internal stuff
174 <DirectoryMatch "__INTRANET_WWW_DIR__/.*/(modules|xslt|includes)">
179 <IfModule mod_gzip.c>
182 mod_gzip_keep_workfiles No
183 mod_gzip_can_negotiate yes
184 mod_gzip_update_static No
185 mod_gzip_temp_dir /tmp
186 mod_gzip_minimum_file_size 512
187 mod_gzip_maximum_file_size 1000000
188 mod_gzip_maximum_inmem_size 1000000
189 mod_gzip_handle_methods GET POST
190 mod_gzip_item_exclude reqheader "User-Agent: .*Mozilla/4\..*\["
191 mod_gzip_item_exclude mime ^image/.*
192 mod_gzip_item_exclude rspheader Content-Type:image/*
193 mod_gzip_item_include file \.js$
194 mod_gzip_item_include mime ^application/javascript$
195 mod_gzip_item_include mime ^application/x-javascript$
196 mod_gzip_item_include file \.php$
197 mod_gzip_item_include mime ^text/html$
198 mod_gzip_item_include file \.css$
199 mod_gzip_item_include mime ^text/css$
202 <IfModule mod_deflate.c>
204 # Compress content with type html, text, and css, ...
205 AddOutputFilterByType DEFLATE text/plain text/html text/xml text/css
206 AddOutputFilterByType DEFLATE application/xml application/xhtml+xml application/rss+xml application/javascript application/x-javascript
208 DeflateCompressionLevel 9
210 # Properly handle old browsers that do not support compression
211 BrowserMatch ^Mozilla/4 gzip-only-text/html
212 BrowserMatch ^Mozilla/4\.0[678] no-gzip
213 BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
215 DeflateFilterNote Input instream
216 DeflateFilterNote Output outstream
217 DeflateFilterNote Ratio ratio
219 LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
220 <IfModule mod_headers.c>
221 #properly handle requests coming from behind proxies
222 Header append Vary User-Agent
226 <IfModule mod_rewrite.c>
230 # Uncomment to turn on rewrite logging
231 #RewriteLog __LOG_DIR__/koha-intranet-rewrite.log
234 #The following two directives are unnecessary to proper Koha functioning.
235 #RewriteCond %{QUERY_STRING} (.*?)(?:[A-Za-z0-9_-]+)=&(.*)
236 #RewriteRule (.+) $1?%1%2 [N,R,NE]
237 RewriteRule ^/bib/([^\/]*)/?$ /cgi-bin/koha/detail\.pl?bib=$1 [PT]
238 RewriteRule ^/isbn/([^\/]*)/?$ /search?q=isbn:$1 [PT]
239 RewriteRule ^/issn/([^\/]*)/?$ /search?q=issn:$1 [PT]
240 RewriteRule ^(.*)_[0-9]{2}\.[0-9]{7}\.(js|css)$ $1.$2 [L]
243 # REST API configuration
244 Alias "/api" "__API_CGI_DIR__"
245 <Directory __API_CGI_DIR__>
246 Options +ExecCGI +FollowSymlinks
247 AddHandler cgi-script .pl
249 SetEnv MOJO_MODE "production"
253 RewriteCond %{REQUEST_FILENAME} !-f
254 RewriteCond %{REQUEST_FILENAME} !-d
255 RewriteCond %{DOCUMENT_ROOT}/../api/$1/app.pl -f
256 RewriteRule ^(.*?)/.* $1/app.pl/api/$0 [L]
260 <IfModule mod_expires.c>
262 ExpiresByType text/css "access plus 60 days"
263 ExpiresByType application/javascript "access plus 60 days"
264 ExpiresByType image/png "access plus 12 hours"
265 ExpiresByType image/gif "access plus 12 hours"
269 # Uncomment this VirtualHost to enable API access through
270 # api.__WEBSERVER_HOST__:__WEBSERVER_PORT__
271 #<VirtualHost __WEBSERVER_IP__:__WEBSERVER_PORT__>
272 # ServerAdmin __WEBMASTER_EMAIL__
273 # DocumentRoot __INTRANET_CGI_DIR__/api
274 # ServerName api.__WEBSERVER_HOST__:__WEBSERVER_PORT__
275 # SetEnv KOHA_CONF "__KOHA_CONF_DIR__/koha-conf.xml"
276 # SetEnv PERL5LIB "__PERL_MODULE_DIR__"
277 # ErrorLog __LOG_DIR__/koha-api-error_log
279 # <IfModule mod_rewrite.c>
280 # <Directory __API_CGI_DIR__>
281 # Options +ExecCGI +FollowSymlinks
282 # AddHandler cgi-script .pl
284 # SetEnv MOJO_MODE "production"
288 # RewriteRule ^api/(.*) $1 [L]
290 # RewriteCond %{REQUEST_FILENAME} !-f
291 # RewriteCond %{REQUEST_FILENAME} !-d
292 # RewriteCond %{DOCUMENT_ROOT}/$1/app.pl -f
293 # RewriteRule ^(.*?)/.* $1/app.pl/api/$0 [L]