httpd-std.conf.in revision 8f9e3d3dc602155a189ed2f30ad4707af56a8368
beaad6ac31022179c44d88536811e9ccd9425696nd# Based upon the NCSA server configuration files originally by Rob McCool.
6fbd2e53c97ea6976d93e0ac521adabc55e0fb73nd# This is the main Apache server configuration file. It contains the
beaad6ac31022179c44d88536811e9ccd9425696nd# configuration directives that give the server its instructions.
beaad6ac31022179c44d88536811e9ccd9425696nd# See <URL:http://httpd.apache.org/docs-2.0/> for detailed information about
beaad6ac31022179c44d88536811e9ccd9425696nd# the directives.
beaad6ac31022179c44d88536811e9ccd9425696nd# Do NOT simply read the instructions in here without understanding
beaad6ac31022179c44d88536811e9ccd9425696nd# what they do. They're here only as hints or reminders. If you are unsure
beaad6ac31022179c44d88536811e9ccd9425696nd# consult the online docs. You have been warned.
beaad6ac31022179c44d88536811e9ccd9425696nd# The configuration directives are grouped into three basic sections:
beaad6ac31022179c44d88536811e9ccd9425696nd# 1. Directives that control the operation of the Apache server process as a
beaad6ac31022179c44d88536811e9ccd9425696nd# whole (the 'global environment').
beaad6ac31022179c44d88536811e9ccd9425696nd# 2. Directives that define the parameters of the 'main' or 'default' server,
beaad6ac31022179c44d88536811e9ccd9425696nd# which responds to requests that aren't handled by a virtual host.
beaad6ac31022179c44d88536811e9ccd9425696nd# These directives also provide default values for the settings
01c674544bd4c211141bcd9fb09b96ffc18c6c3dnd# of all virtual hosts.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# 3. Settings for virtual hosts, which allow Web requests to be sent to
01c674544bd4c211141bcd9fb09b96ffc18c6c3dnd# different IP addresses or hostnames and have them handled by the
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# same Apache server process.
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# Configuration and logfile names: If the filenames you specify for many
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# of the server's control files begin with "/" (or "drive:/" for Win32), the
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# server will use that explicit path. If the filenames do *not* begin
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# with "/", the value of ServerRoot is prepended -- so "@rel_logfiledir@/foo.log"
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# with ServerRoot set to "@@ServerRoot@@" will be interpreted by the
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# server as "@@ServerRoot@@/@rel_logfiledir@/foo.log".
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd### Section 1: Global Environment
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# The directives in this section affect the overall operation of Apache,
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# such as the number of concurrent requests it can handle or where it
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# can find its configuration files.
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# ServerRoot: The top of the directory tree under which the server's
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# configuration, error, and log files are kept.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# NOTE! If you intend to place this on an NFS (or otherwise network)
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# mounted filesystem then please read the LockFile documentation
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# (available at <URL:http://httpd.apache.org/docs-2.0/mod/core.html#lockfile>);
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# you will save yourself a lot of trouble.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# Do NOT add a slash at the end of the directory path.
66e48875fca2df6669dab4f2690ee36c6913c0ffndServerRoot "@@ServerRoot@@"
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# The accept serialization lock file MUST BE STORED ON A LOCAL DISK.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd#LockFile @rel_logfiledir@/accept.lock
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
8cfbcde8e416fd60132dd4324c42a5098da156cfnd# ScoreBoardFile: File used to store internal server process information.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# If unspecified (the default), the scoreboard will be stored in an
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# anonymous shared memory segment, and will be unavailable to third-party
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# applications.
f5f948a91315652103ddae08be22d76f63ba96d4nd# If specified, ensure that no two invocations of Apache share the same
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# scoreboard file. The scoreboard file MUST BE STORED ON A LOCAL DISK.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd#ScoreBoardFile @rel_logfiledir@/apache_runtime_status
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# PidFile: The file in which the server should record its process
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# identification number when it starts.
7e68fce3cbd2246164e045a51ecd77f9f26680edndPidFile @rel_logfiledir@/httpd.pid
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# Timeout: The number of seconds before receives and sends time out.
7e68fce3cbd2246164e045a51ecd77f9f26680edndTimeout 300
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# KeepAlive: Whether or not to allow persistent connections (more than
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# one request per connection). Set to "Off" to deactivate.
7e68fce3cbd2246164e045a51ecd77f9f26680edndKeepAlive On
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxKeepAliveRequests: The maximum number of requests to allow
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# during a persistent connection. Set to 0 to allow an unlimited amount.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# We recommend you leave this number high, for maximum performance.
f5f948a91315652103ddae08be22d76f63ba96d4ndMaxKeepAliveRequests 100
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# KeepAliveTimeout: Number of seconds to wait for the next request from the
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# same client on the same connection.
7e68fce3cbd2246164e045a51ecd77f9f26680edndKeepAliveTimeout 15
7e68fce3cbd2246164e045a51ecd77f9f26680ednd## Server-Pool Size Regulation (MPM specific)
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# prefork MPM
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# StartServers: number of server processes to start
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MinSpareServers: minimum number of server processes which are kept spare
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxSpareServers: maximum number of server processes which are kept spare
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxClients: maximum number of server processes allowed to start
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxRequestsPerChild: maximum number of requests a server process serves
7e68fce3cbd2246164e045a51ecd77f9f26680edndStartServers 5
7e68fce3cbd2246164e045a51ecd77f9f26680edndMinSpareServers 5
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxSpareServers 10
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxClients 150
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxRequestsPerChild 0
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# worker MPM
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# StartServers: initial number of server processes to start
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxClients: maximum number of simultaneous client connections
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MinSpareThreads: minimum number of worker threads which are kept spare
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxSpareThreads: maximum number of worker threads which are kept spare
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# ThreadsPerChild: constant number of worker threads in each server process
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# MaxRequestsPerChild: maximum number of requests a server process serves
7e68fce3cbd2246164e045a51ecd77f9f26680edndStartServers 2
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxClients 150
7e68fce3cbd2246164e045a51ecd77f9f26680edndMinSpareThreads 25
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26ndMaxSpareThreads 75
7e68fce3cbd2246164e045a51ecd77f9f26680edndThreadsPerChild 25
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxRequestsPerChild 0
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# perchild MPM
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# NumServers: constant number of server processes
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# StartThreads: initial number of worker threads in each server process
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# MinSpareThreads: minimum number of worker threads which are kept spare
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# MaxSpareThreads: maximum number of worker threads which are kept spare
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxThreadsPerChild: maximum number of worker threads in each server process
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxRequestsPerChild: maximum number of connections per server process
7e68fce3cbd2246164e045a51ecd77f9f26680edndNumServers 5
7e68fce3cbd2246164e045a51ecd77f9f26680edndStartThreads 5
7e68fce3cbd2246164e045a51ecd77f9f26680edndMinSpareThreads 5
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxSpareThreads 10
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxThreadsPerChild 20
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxRequestsPerChild 0
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# WinNT MPM
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# ThreadsPerChild: constant number of worker threads in the server process
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxRequestsPerChild: maximum number of requests a server process serves
7e68fce3cbd2246164e045a51ecd77f9f26680edndThreadsPerChild 250
66e48875fca2df6669dab4f2690ee36c6913c0ffndMaxRequestsPerChild 0
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd</IfModule>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# StartThreads: how many threads do we initially spawn?
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxClients: max number of threads we can have (1 thread == 1 client)
66e48875fca2df6669dab4f2690ee36c6913c0ffnd# MaxRequestsPerThread: maximum number of requests each thread will process
7e68fce3cbd2246164e045a51ecd77f9f26680edndStartThreads 10
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxClients 50
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26ndMaxRequestsPerThread 10000
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# NetWare MPM
fe4f1730693292317276e92e62e219422407c949nd# ThreadStackSize ...... Stack size allocated for each worker thread
fe4f1730693292317276e92e62e219422407c949nd# StartThreads ......... Number of worker threads launched at server startup
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# MinSpareThreads ...... Minimum number of idle threads, to handle request spikes
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxSpareThreads ...... Maximum number of idle threads
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# MaxThreads ........... Maximum number of worker threads alive at the same time
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# MaxRequestsPerChild .. Maximum number of requests a thread serves. It is
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# recommended that the default value of 0 be set for this
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# directive on NetWare. This will allow the thread to
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# continue to service requests indefinitely.
7e68fce3cbd2246164e045a51ecd77f9f26680edndThreadStackSize 65536
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26ndStartThreads 250
7e68fce3cbd2246164e045a51ecd77f9f26680edndMinSpareThreads 25
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxSpareThreads 250
7e68fce3cbd2246164e045a51ecd77f9f26680edndMaxThreads 1000
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26ndMaxRequestsPerChild 0
7e68fce3cbd2246164e045a51ecd77f9f26680ednd</IfModule>
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# Listen: Allows you to bind Apache to specific IP addresses and/or
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# ports, in addition to the default. See also the <VirtualHost>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# directive.
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# Change this to Listen on specific IP addresses as shown below to
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# prevent Apache from glomming onto all bound IP addresses (0.0.0.0)
7e68fce3cbd2246164e045a51ecd77f9f26680ednd#Listen 12.34.56.78:80
7e68fce3cbd2246164e045a51ecd77f9f26680edndListen @@Port@@
7e68fce3cbd2246164e045a51ecd77f9f26680ednd# Dynamic Shared Object (DSO) Support
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd# To be able to use the functionality of a module which was built as a DSO you
# LoadModule foo_module modules/mod_foo.so
<IfModule !mpm_winnt.c>
<IfModule !mpm_netware.c>
# as error documents. e.g. admin@your-domain.com
#ServerName new.host.name:80
# to which services and features are allowed and/or disabled in that
# The index.html.var file (a type-map) is used to deliver content-
# TypesConfig describes where the mime.types file (or equivalent) is
TypesConfig @rel_sysconfdir@/mime.types
# If your server contains mostly text or HTML documents, "text/plain" is
# or images, you may want to use "application/octet-stream" instead to
DefaultType text/plain
<IfModule mod_mime_magic.c>
# This should be changed to the ServerRoot/manual/. The alias provides
<IfModule mod_cgid.c>
# Additional to mod_cgid.c settings, mod_cgid has Scriptsock <path>
# Redirect permanent /foo http://www.example.com/bar
# compared in the natural way, so that `apache-1.3.9.tar' is placed before
# `apache-1.3.12.tar'.
AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
AddIconByType (TXT,/icons/text.gif) text/*
AddIconByType (IMG,/icons/image2.gif) image/*
AddIconByType (SND,/icons/sound2.gif) audio/*
AddIconByType (VID,/icons/movie.gif) video/*
AddIcon /icons/binary.gif .bin .exe
AddIcon /icons/binhex.gif .hqx
AddIcon /icons/tar.gif .tar
AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
AddIcon /icons/a.gif .ps .ai .eps
AddIcon /icons/layout.gif .html .shtml .htm .pdf
AddIcon /icons/text.gif .txt
AddIcon /icons/c.gif .c
AddIcon /icons/p.gif .pl .py
AddIcon /icons/f.gif .for
AddIcon /icons/dvi.gif .dvi
AddIcon /icons/uuencoded.gif .uu
AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
AddIcon /icons/tex.gif .tex
AddIcon /icons/bomb.gif core
AddIcon /icons/back.gif ..
AddIcon /icons/hand.right.gif README
AddIcon /icons/folder.gif ^^DIRECTORY^^
AddIcon /icons/blank.gif ^^BLANKICON^^
DefaultIcon /icons/unknown.gif
ReadmeName README.html
HeaderName HEADER.html
# is in iso-8859-1 (latin1) unless specified otherwise i.e. you
# file mime.types for specific file types.
AddType application/x-tar .tgz
# 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;
# copying them to /your/include/path/, even on a per-VirtualHost basis.
<IfModule mod_negotiation.c>
<IfModule mod_include.c>
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
# Allow server status reports, with the URL of http://servername/server-status
# Change the ".your-domain.com" to match your domain to enable.
# Allow from .your-domain.com
# Change the ".your-domain.com" to match your domain to enable.
# Allow from .your-domain.com
#<IfModule mod_proxy.c>
# Allow from .your-domain.com
# Enable/disable the handling of HTTP/1.1 "Via:" headers.
<IfModule mod_ssl.c>
Include @rel_sysconfdir@/ssl.conf
# VirtualHost: If you want to maintain multiple domains/hostnames on your
# DocumentRoot /www/docs/dummy-host.example.com
# ServerName dummy-host.example.com
# ErrorLog @rel_logfiledir@/dummy-host.example.com-error_log
# CustomLog @rel_logfiledir@/dummy-host.example.com-access_log common