httpd-win.conf revision 8cfbcde8e416fd60132dd4324c42a5098da156cf
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke# Based upon the NCSA server configuration files originally by Rob McCool.
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke# This is the main Apache server configuration file. It contains the
98890889ffb2e8f6f722b00e265a211f13b5a861Corneliu-Claudiu Prodescu# configuration directives that give the server its instructions.
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke# See <URL:http://httpd.apache.org/docs-2.1/> for detailed information about
2eeec5240b424984e3ee26296da1eeab6c6d739eChristian Maeder# the directives.
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke# Do NOT simply read the instructions in here without understanding
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke# what they do. They're here only as hints or reminders. If you are unsure
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke# consult the online docs. You have been warned.
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke# The configuration directives are grouped into three basic sections:
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke# 1. Directives that control the operation of the Apache server process as a
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke# whole (the 'global environment').
cf04ba46b9eb495d334466e24e082e391055ca7bDominik Luecke# 2. Directives that define the parameters of the 'main' or 'default' server,
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke# which responds to requests that aren't handled by a virtual host.
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke# These directives also provide default values for the settings
926b3c5491f1c608f5b79e2d8014d7a1385558c3Dominik Luecke# of all virtual hosts.
2af38fde95f93562f2124ec615fba0e509c8202eDominik Luecke# 3. Settings for virtual hosts, which allow Web requests to be sent to
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke# different IP addresses or hostnames and have them handled by the
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke# same Apache server process.
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# Configuration and logfile names: If the filenames you specify for many
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# of the server's control files begin with "/" (or "drive:/" for Win32), the
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# server will use that explicit path. If the filenames do *not* begin
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# with "/", the value of ServerRoot is prepended -- so "logs/foo.log"
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# with ServerRoot set to "@@ServerRoot@@" will be interpreted by the
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# server as "@@ServerRoot@@/logs/foo.log".
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# NOTE: Where filenames are specified, you must use forward slashes
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# instead of backslashes (e.g., "c:/apache" instead of "c:\apache").
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# If a drive letter is omitted, the drive on which Apache.exe is located
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder# will be used by default. It is recommended that you always supply
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# an explicit drive letter in absolute paths, however, to avoid
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke### Section 1: Global Environment
2ea0ce749d2525f96d5d2f285f519ab07b005b8dDominik Luecke# The directives in this section affect the overall operation of Apache,
5b9f5c1b3592b99fc74d3438740ebcf9eb4c94beDominik Luecke# such as the number of concurrent requests it can handle or where it
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke# can find its configuration files.
da955132262baab309a50fdffe228c9efe68251dCui Jian# ServerRoot: The top of the directory tree under which the server's
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# configuration, error, and log files are kept.
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# NOTE! If you intend to place this on an NFS (or otherwise network)
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# mounted filesystem then please read the LockFile documentation (available
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# at <URL:http://httpd.apache.org/docs-2.1/mod/mpm_common.html#lockfile>);
16e124196c6b204769042028c74f533509c9b5d3Christian Maeder# you will save yourself a lot of trouble.
fcac596b16bb10f475066c323b9b1ca44db2b755Dominik Luecke# Do NOT add a slash at the end of the directory path.
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# ScoreBoardFile: File used to store internal server process information.
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke# If unspecified (the default), the scoreboard will be stored in an
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke# anonymous shared memory segment, and will be unavailable to third-party
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke# applications.
da955132262baab309a50fdffe228c9efe68251dCui Jian# If specified, ensure that no two invocations of Apache share the same
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# scoreboard file. The scoreboard file MUST BE STORED ON A LOCAL DISK.
548f3850942936a8c6021185c8391dfcd3b03018Dominik Luecke# PidFile: The file in which the server should record its process
548f3850942936a8c6021185c8391dfcd3b03018Dominik Luecke# identification number when it starts.
5b2e9f4673599e1bc6e18a43ad615da28305b8e1Christian Maeder# Timeout: The number of seconds before receives and sends time out.
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# KeepAlive: Whether or not to allow persistent connections (more than
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# one request per connection). Set to "Off" to deactivate.
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# MaxKeepAliveRequests: The maximum number of requests to allow
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# during a persistent connection. Set to 0 to allow an unlimited amount.
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# We recommend you leave this number high, for maximum performance.
fcac596b16bb10f475066c323b9b1ca44db2b755Dominik Luecke# KeepAliveTimeout: Number of seconds to wait for the next request from the
fcac596b16bb10f475066c323b9b1ca44db2b755Dominik Luecke# same client on the same connection.
5b9f5c1b3592b99fc74d3438740ebcf9eb4c94beDominik Luecke## Server-Pool Size Regulation (MPM specific)
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# ThreadsPerChild: constant number of worker threads in the server process
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# MaxRequestsPerChild: maximum number of requests a server process serves
2ea0ce749d2525f96d5d2f285f519ab07b005b8dDominik Luecke# Listen: Allows you to bind Apache to specific IP addresses and/or
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# ports, instead of the default. See also the <VirtualHost>
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# Change this to Listen on specific IP addresses as shown below to
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# prevent Apache from glomming onto all bound IP addresses (0.0.0.0)
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder#Listen 12.34.56.78:80
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# Dynamic Shared Object (DSO) Support
a7be28e157e9ceeec73a8fd0e642c36ea29d4218Christian Maeder# To be able to use the functionality of a module which was built as a DSO you
0b53895114b00141ec17ffdc7e26acded4487328Christian Maeder# have to place corresponding `LoadModule' lines at this location so the
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder# directives contained in it are actually available _before_ they are used.
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder# Statically compiled modules (those listed by `httpd -l') do not need
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder# to be loaded here.
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder# LoadModule foo_module modules/mod_foo.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule actions_module modules/mod_actions.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule alias_module modules/mod_alias.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule auth_basic_module modules/mod_auth_basic.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder#LoadModule auth_digest_module modules/mod_auth_digest.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder#LoadModule authn_anon_module modules/mod_authn_anon.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder#LoadModule authn_dbm_module modules/mod_authn_dbm.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule authn_default_module modules/mod_authn_default.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule authn_file_module modules/mod_authn_file.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian Maeder#LoadModule authz_dbm_module modules/mod_authz_dbm.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule authz_default_module modules/mod_authz_default.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule authz_groupfile_module modules/mod_authz_groupfile.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule authz_host_module modules/mod_authz_host.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule authz_user_module modules/mod_authz_user.so
202df46772cac2ee2e8627ba196a5faebb6f9a05Christian MaederLoadModule autoindex_module modules/mod_autoindex.so
#LoadModule cern_meta_module modules/mod_cern_meta.so
#LoadModule dav_module modules/mod_dav.so
#LoadModule dav_fs_module modules/mod_dav_fs.so
#LoadModule expires_module modules/mod_expires.so
#LoadModule file_cache_module modules/mod_file_cache.so
#LoadModule headers_module modules/mod_headers.so
#LoadModule info_module modules/mod_info.so
#LoadModule mime_magic_module modules/mod_mime_magic.so
#LoadModule proxy_module modules/mod_proxy.so
#LoadModule proxy_connect_module modules/mod_proxy_connect.so
#LoadModule proxy_http_module modules/mod_proxy_http.so
#LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
#LoadModule rewrite_module modules/mod_rewrite.so
#LoadModule speling_module modules/mod_speling.so
#LoadModule status_module modules/mod_status.so
#LoadModule unique_id_module modules/mod_unique_id.so
#LoadModule usertrack_module modules/mod_usertrack.so
#LoadModule vhost_alias_module modules/mod_vhost_alias.so
#LoadModule ssl_module modules/mod_ssl.so
# as error documents. e.g. admin@your-domain.com
<Directory />
</Directory>
</Directory>
# The index.html.var file (a type-map) is used to deliver content-
</Files>
# TypesConfig describes where the mime.types file (or equivalent) is
# or images, you may want to use "application/octet-stream" instead to
</IfModule>
# e.g., www.apache.org (on) or 204.62.129.132 (off).
# http://httpd.apache.org/docs-2.1/mod/core.html#enablemmap
# http://httpd.apache.org/docs-2.1/mod/core.html#enablesendfile
# LogLevel: Control the number of messages logged to the error.log.
# You need to enable mod_logio.c to use %I and %O
#CustomLog logs/referer.log referer
#CustomLog logs/access.log combined
</Directory>
# This should be changed to the ServerRoot/manual/. The alias provides
</Directory>
</Directory>
# Redirect permanent /foo http://www.example.com/bar
# is in iso-8859-1 (latin1) unless specified otherwise i.e. you
# See http://www.iana.org/assignments/character-sets for the
# file mime.types for specific file types.
# Format: Action media/type /cgi-script/location
# Format: Action handler-name /cgi-script/location
#ErrorDocument 404 /missing.html
#ErrorDocument 404 "/cgi-bin/missing_handler.pl"
#ErrorDocument 402 http://www.example.com/subscription_info.html
# default HTTP_<error>.html.var files by adding the line:
# ErrorDocument 400 /error/HTTP_BAD_REQUEST.html.var
# ErrorDocument 401 /error/HTTP_UNAUTHORIZED.html.var
# ErrorDocument 403 /error/HTTP_FORBIDDEN.html.var
# ErrorDocument 404 /error/HTTP_NOT_FOUND.html.var
# ErrorDocument 405 /error/HTTP_METHOD_NOT_ALLOWED.html.var
# ErrorDocument 408 /error/HTTP_REQUEST_TIME_OUT.html.var
# ErrorDocument 410 /error/HTTP_GONE.html.var
# ErrorDocument 411 /error/HTTP_LENGTH_REQUIRED.html.var
# ErrorDocument 412 /error/HTTP_PRECONDITION_FAILED.html.var
# ErrorDocument 413 /error/HTTP_REQUEST_ENTITY_TOO_LARGE.html.var
# ErrorDocument 414 /error/HTTP_REQUEST_URI_TOO_LARGE.html.var
# ErrorDocument 415 /error/HTTP_SERVICE_UNAVAILABLE.html.var
# ErrorDocument 500 /error/HTTP_INTERNAL_SERVER_ERROR.html.var
# ErrorDocument 501 /error/HTTP_NOT_IMPLEMENTED.html.var
# ErrorDocument 502 /error/HTTP_BAD_GATEWAY.html.var
# ErrorDocument 503 /error/HTTP_SERVICE_UNAVAILABLE.html.var
# ErrorDocument 506 /error/HTTP_VARIANT_ALSO_VARIES.html.var
# with the URL of http://servername/server-status
# http://servername/server-info (requires that mod_info.c be loaded).
#<IfModule mod_proxy.c>
# Allow from .example.com
</IfModule>
# DocumentRoot /www/docs/dummy-host.example.com
# ServerName dummy-host.example.com
# ErrorLog logs/dummy-host.example.com-error_log
# CustomLog logs/dummy-host.example.com-access_log common