2
# This is the main Apache HTTP server configuration file. It contains the
3
# configuration directives that give the server its instructions.
4
# See <URL:http://httpd.apache.org/docs/2.2> for detailed information.
6
# <URL:http://httpd.apache.org/docs/2.2/mod/directives.html>
7
# for a discussion of each configuration directive.
9
# Do NOT simply read the instructions in here without understanding
10
# what they do. They're here only as hints or reminders. If you are unsure
11
# consult the online docs. You have been warned.
13
# Configuration and logfile names: If the filenames you specify for many
14
# of the server's control files begin with "/" (or "drive:/" for Win32), the
15
# server will use that explicit path. If the filenames do *not* begin
16
# with "/", the value of ServerRoot is prepended -- so "@rel_logfiledir@/foo.log"
17
# with ServerRoot set to "@@ServerRoot@@" will be interpreted by the
18
# server as "@@ServerRoot@@/@rel_logfiledir@/foo.log".
21
# ServerRoot: The top of the directory tree under which the server's
22
# configuration, error, and log files are kept.
24
# Do not add a slash at the end of the directory path. If you point
25
# ServerRoot at a non-local disk, be sure to point the LockFile directive
26
# at a local disk. If you wish to share the same ServerRoot for multiple
27
# httpd daemons, you will need to change at least LockFile and PidFile.
29
ServerRoot "@@ServerRoot@@"
32
# Listen: Allows you to bind Apache to specific IP addresses and/or
33
# ports, instead of the default. See also the <VirtualHost>
36
# Change this to Listen on specific IP addresses as shown below to
37
# prevent Apache from glomming onto all bound IP addresses.
39
#Listen 12.34.56.78:80
43
# Dynamic Shared Object (DSO) Support
45
# To be able to use the functionality of a module which was built as a DSO you
46
# have to place corresponding `LoadModule' lines at this location so the
47
# directives contained in it are actually available _before_ they are used.
48
# Statically compiled modules (those listed by `httpd -l') do not need
52
# LoadModule foo_module modules/mod_foo.so
56
<IfModule !mpm_netware_module>
58
# If you wish httpd to run as a different user or group, you must run
59
# httpd as root initially and it will switch.
61
# User/Group: The name (or #number) of the user/group to run httpd as.
62
# It is usually good practice to create a dedicated user and group for
63
# running httpd, as with most system services.
69
# 'Main' server configuration
71
# The directives in this section set up the values used by the 'main'
72
# server, which responds to any requests that aren't handled by a
73
# <VirtualHost> definition. These values also provide defaults for
74
# any <VirtualHost> containers you may define later in the file.
76
# All of these directives may appear inside <VirtualHost> containers,
77
# in which case these default settings will be overridden for the
78
# virtual host being defined.
82
# ServerAdmin: Your address, where problems with the server should be
83
# e-mailed. This address appears on some server-generated pages, such
84
# as error documents. e.g. admin@your-domain.com
86
ServerAdmin you@example.com
89
# ServerName gives the name and port that the server uses to identify itself.
90
# This can often be determined automatically, but we recommend you specify
91
# it explicitly to prevent problems during startup.
93
# If your host doesn't have a registered DNS name, enter its IP address here.
95
#ServerName www.example.com:80
98
# DocumentRoot: The directory out of which you will serve your
99
# documents. By default, all requests are taken from this directory, but
100
# symbolic links and aliases may be used to point to other locations.
102
DocumentRoot "@exp_htdocsdir@"
105
# Each directory to which Apache has access can be configured with respect
106
# to which services and features are allowed and/or disabled in that
107
# directory (and its subdirectories).
109
# First, we configure the "default" to be a very restrictive set of
113
Options FollowSymLinks
120
# Note that from this point forward you must specifically allow
121
# particular features to be enabled - so if something's not working as
122
# you might expect, make sure that you have specifically enabled it
127
# This should be changed to whatever you set DocumentRoot to.
129
<Directory "@exp_htdocsdir@">
131
# Possible values for the Options directive are "None", "All",
132
# or any combination of:
133
# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
135
# Note that "MultiViews" must be named *explicitly* --- "Options All"
136
# doesn't give it to you.
138
# The Options directive is both complicated and important. Please see
139
# http://httpd.apache.org/docs/2.2/mod/core.html#options
140
# for more information.
142
Options Indexes FollowSymLinks
145
# AllowOverride controls what directives may be placed in .htaccess files.
146
# It can be "All", "None", or any combination of the keywords:
147
# Options FileInfo AuthConfig Limit
152
# Controls who can get stuff from this server.
160
# DirectoryIndex: sets the file that Apache will serve if a directory
163
<IfModule dir_module>
164
DirectoryIndex index.html
168
# The following lines prevent .htaccess and .htpasswd files from being
169
# viewed by Web clients.
178
# ErrorLog: The location of the error log file.
179
# If you do not specify an ErrorLog directive within a <VirtualHost>
180
# container, error messages relating to that virtual host will be
181
# logged here. If you *do* define an error logfile for a <VirtualHost>
182
# container, that host's errors will be logged there and not here.
184
ErrorLog @rel_logfiledir@/error_log
187
# LogLevel: Control the number of messages logged to the error_log.
188
# Possible values include: debug, info, notice, warn, error, crit,
193
<IfModule log_config_module>
195
# The following directives define some format nicknames for use with
196
# a CustomLog directive (see below).
198
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
199
LogFormat "%h %l %u %t \"%r\" %>s %b" common
201
<IfModule logio_module>
202
# You need to enable mod_logio.c to use %I and %O
203
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
207
# The location and format of the access logfile (Common Logfile Format).
208
# If you do not define any access logfiles within a <VirtualHost>
209
# container, they will be logged here. Contrariwise, if you *do*
210
# define per-<VirtualHost> access logfiles, transactions will be
211
# logged therein and *not* in this file.
213
CustomLog @rel_logfiledir@/access_log common
216
# If you prefer a logfile with access, agent, and referer information
217
# (Combined Logfile Format) you can use the following directive.
219
#CustomLog @rel_logfiledir@/access_log combined
222
<IfModule alias_module>
224
# Redirect: Allows you to tell clients about documents that used to
225
# exist in your server's namespace, but do not anymore. The client
226
# will make a new request for the document at its new location.
228
# Redirect permanent /foo http://www.example.com/bar
231
# Alias: Maps web paths into filesystem paths and is used to
232
# access content that does not live under the DocumentRoot.
234
# Alias /webpath /full/filesystem/path
236
# If you include a trailing / on /webpath then the server will
237
# require it to be present in the URL. You will also likely
238
# need to provide a <Directory> section to allow access to
239
# the filesystem path.
242
# ScriptAlias: This controls which directories contain server scripts.
243
# ScriptAliases are essentially the same as Aliases, except that
244
# documents in the target directory are treated as applications and
245
# run by the server when requested rather than as documents sent to the
246
# client. The same rules about trailing "/" apply to ScriptAlias
247
# directives as to Alias.
249
ScriptAlias /cgi-bin/ "@exp_cgidir@/"
253
<IfModule cgid_module>
255
# ScriptSock: On threaded servers, designate the path to the UNIX
256
# socket used to communicate with the CGI daemon of mod_cgid.
258
#Scriptsock @rel_runtimedir@/cgisock
262
# "@exp_cgidir@" should be changed to whatever your ScriptAliased
263
# CGI directory exists, if you have that configured.
265
<Directory "@exp_cgidir@">
273
# DefaultType: the default MIME type the server will use for a document
274
# if it cannot otherwise determine one, such as from filename extensions.
275
# If your server contains mostly text or HTML documents, "text/plain" is
276
# a good value. If most of your content is binary, such as applications
277
# or images, you may want to use "application/octet-stream" instead to
278
# keep browsers from trying to display binary files as though they are
281
DefaultType text/plain
283
<IfModule mime_module>
285
# TypesConfig points to the file containing the list of mappings from
286
# filename extension to MIME-type.
288
TypesConfig @rel_sysconfdir@/mime.types
291
# AddType allows you to add to or override the MIME configuration
292
# file specified in TypesConfig for specific file types.
294
#AddType application/x-gzip .tgz
296
# AddEncoding allows you to have certain browsers uncompress
297
# information on the fly. Note: Not all browsers support this.
299
#AddEncoding x-compress .Z
300
#AddEncoding x-gzip .gz .tgz
302
# If the AddEncoding directives above are commented-out, then you
303
# probably should define those extensions to indicate media types:
305
AddType application/x-compress .Z
306
AddType application/x-gzip .gz .tgz
309
# AddHandler allows you to map certain file extensions to "handlers":
310
# actions unrelated to filetype. These can be either built into the server
311
# or added with the Action directive (see below)
313
# To use CGI scripts outside of ScriptAliased directories:
314
# (You will also need to add "ExecCGI" to the "Options" directive.)
316
#AddHandler cgi-script .cgi
318
# For type maps (negotiated resources):
319
#AddHandler type-map var
322
# Filters allow you to process content before it is sent to the client.
324
# To parse .shtml files for server-side includes (SSI):
325
# (You will also need to add "Includes" to the "Options" directive.)
327
#AddType text/html .shtml
328
#AddOutputFilter INCLUDES .shtml
332
# The mod_mime_magic module allows the server to use various hints from the
333
# contents of the file itself to determine its type. The MIMEMagicFile
334
# directive tells the module where the hint definitions are located.
336
#MIMEMagicFile @rel_sysconfdir@/magic
339
# Customizable error responses come in three flavors:
340
# 1) plain text 2) local redirects 3) external redirects
343
#ErrorDocument 500 "The server made a boo boo."
344
#ErrorDocument 404 /missing.html
345
#ErrorDocument 404 "/cgi-bin/missing_handler.pl"
346
#ErrorDocument 402 http://www.example.com/subscription_info.html
350
# EnableMMAP and EnableSendfile: On systems that support it,
351
# memory-mapping or the sendfile syscall is used to deliver
352
# files. This usually improves server performance, but must
353
# be turned off when serving from networked-mounted
354
# filesystems or if support for these functions is otherwise
355
# broken on your system.
360
# Supplemental configuration
362
# The configuration files in the @rel_sysconfdir@/extra/ directory can be
363
# included to add extra features or to modify the default configuration of
364
# the server, or you may simply copy their contents here and change as
367
# Server-pool management (MPM specific)
368
#Include @rel_sysconfdir@/extra/httpd-mpm.conf
370
# Multi-language error messages
371
#Include @rel_sysconfdir@/extra/httpd-multilang-errordoc.conf
373
# Fancy directory listings
374
#Include @rel_sysconfdir@/extra/httpd-autoindex.conf
377
#Include @rel_sysconfdir@/extra/httpd-languages.conf
379
# User home directories
380
#Include @rel_sysconfdir@/extra/httpd-userdir.conf
382
# Real-time info on requests and configuration
383
#Include @rel_sysconfdir@/extra/httpd-info.conf
386
#Include @rel_sysconfdir@/extra/httpd-vhosts.conf
388
# Local access to the Apache HTTP Server Manual
389
#Include @rel_sysconfdir@/extra/httpd-manual.conf
391
# Distributed authoring and versioning (WebDAV)
392
#Include @rel_sysconfdir@/extra/httpd-dav.conf
394
# Various default settings
395
#Include @rel_sysconfdir@/extra/httpd-default.conf
397
# Secure (SSL/TLS) connections
398
#Include @rel_sysconfdir@/extra/httpd-ssl.conf
400
# Note: The following must must be present to support
401
# starting without SSL on platforms with no /dev/random equivalent
402
# but a statically compiled-in mod_ssl.
404
<IfModule ssl_module>
405
SSLRandomSeed startup builtin
406
SSLRandomSeed connect builtin