1# 2# Based upon the NCSA server configuration files originally by Rob McCool. 3# 4# This is the main Apache server configuration file. It contains the 5# configuration directives that give the server its instructions. 6# See http://httpd.apache.org/docs/2.2/ for detailed information about 7# the directives. 8# 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. 12# 13# The configuration directives are grouped into three basic sections: 14# 1. Directives that control the operation of the Apache server process as a 15# whole (the 'global environment'). 16# 2. Directives that define the parameters of the 'main' or 'default' server, 17# which responds to requests that aren't handled by a virtual host. 18# These directives also provide default values for the settings 19# of all virtual hosts. 20# 3. Settings for virtual hosts, which allow Web requests to be sent to 21# different IP addresses or hostnames and have them handled by the 22# same Apache server process. 23# 24# Configuration and logfile names: If the filenames you specify for many 25# of the server's control files begin with "/" (or "drive:/" for Win32), the 26# server will use that explicit path. If the filenames do *not* begin 27# with "/", the value of ServerRoot is prepended -- so "/var/log/apache2/foo.log" 28# with ServerRoot set to "" will be interpreted by the 29# server as "//var/log/apache2/foo.log". 30# 31 32### Section 1: Global Environment 33# 34# The directives in this section affect the overall operation of Apache, 35# such as the number of concurrent requests it can handle or where it 36# can find its configuration files. 37# 38 39# 40# ServerRoot: The top of the directory tree under which the server's 41# configuration, error, and log files are kept. 42# 43# NOTE! If you intend to place this on an NFS (or otherwise network) 44# mounted filesystem then please read the LockFile documentation (available 45# at <URL:http://httpd.apache.org/docs-2.1/mod/mpm_common.html#lockfile>); 46# you will save yourself a lot of trouble. 47# 48# Do NOT add a slash at the end of the directory path. 49# 50ServerRoot "/etc/apache2" 51 52# 53# The accept serialization lock file MUST BE STORED ON A LOCAL DISK. 54# 55#<IfModule !mpm_winnt.c> 56#<IfModule !mpm_netware.c> 57LockFile /var/lock/apache2/accept.lock 58#</IfModule> 59#</IfModule> 60 61# 62# PidFile: The file in which the server should record its process 63# identification number when it starts. 64# This needs to be set in /etc/apache2/envvars 65# 66PidFile ${APACHE_PID_FILE} 67 68# 69# Timeout: The number of seconds before receives and sends time out. 70# 71Timeout 300 72 73# 74# KeepAlive: Whether or not to allow persistent connections (more than 75# one request per connection). Set to "Off" to deactivate. 76# 77KeepAlive On 78 79# 80# MaxKeepAliveRequests: The maximum number of requests to allow 81# during a persistent connection. Set to 0 to allow an unlimited amount. 82# We recommend you leave this number high, for maximum performance. 83# 84MaxKeepAliveRequests 100 85 86# 87# KeepAliveTimeout: Number of seconds to wait for the next request from the 88# same client on the same connection. 89# 90KeepAliveTimeout 15 91 92## 93## Server-Pool Size Regulation (MPM specific) 94## 95 96# prefork MPM 97# StartServers: number of server processes to start 98# MinSpareServers: minimum number of server processes which are kept spare 99# MaxSpareServers: maximum number of server processes which are kept spare 100# MaxClients: maximum number of server processes allowed to start 101# MaxRequestsPerChild: maximum number of requests a server process serves 102<IfModule mpm_prefork_module> 103 StartServers 5 104 MinSpareServers 5 105 MaxSpareServers 10 106 MaxClients 150 107 MaxRequestsPerChild 0 108</IfModule> 109 110# worker MPM 111# StartServers: initial number of server processes to start 112# MaxClients: maximum number of simultaneous client connections 113# MinSpareThreads: minimum number of worker threads which are kept spare 114# MaxSpareThreads: maximum number of worker threads which are kept spare 115# ThreadsPerChild: constant number of worker threads in each server process 116# MaxRequestsPerChild: maximum number of requests a server process serves 117<IfModule mpm_worker_module> 118 StartServers 2 119 MaxClients 150 120 MinSpareThreads 25 121 MaxSpareThreads 75 122 ThreadsPerChild 25 123 MaxRequestsPerChild 0 124</IfModule> 125 126# These need to be set in /etc/apache2/envvars 127User ${APACHE_RUN_USER} 128Group ${APACHE_RUN_GROUP} 129 130# 131# AccessFileName: The name of the file to look for in each directory 132# for additional configuration directives. See also the AllowOverride 133# directive. 134# 135 136AccessFileName .htaccess 137 138# 139# The following lines prevent .htaccess and .htpasswd files from being 140# viewed by Web clients. 141# 142<Files ~ "^\.ht"> 143 Order allow,deny 144 Deny from all 145</Files> 146 147# 148# DefaultType is the default MIME type the server will use for a document 149# if it cannot otherwise determine one, such as from filename extensions. 150# If your server contains mostly text or HTML documents, "text/plain" is 151# a good value. If most of your content is binary, such as applications 152# or images, you may want to use "application/octet-stream" instead to 153# keep browsers from trying to display binary files as though they are 154# text. 155# 156DefaultType text/plain 157 158 159# 160# HostnameLookups: Log the names of clients or just their IP addresses 161# e.g., www.apache.org (on) or 204.62.129.132 (off). 162# The default is off because it'd be overall better for the net if people 163# had to knowingly turn this feature on, since enabling it means that 164# each client request will result in AT LEAST one lookup request to the 165# nameserver. 166# 167HostnameLookups Off 168 169# ErrorLog: The location of the error log file. 170# If you do not specify an ErrorLog directive within a <VirtualHost> 171# container, error messages relating to that virtual host will be 172# logged here. If you *do* define an error logfile for a <VirtualHost> 173# container, that host's errors will be logged there and not here. 174# 175ErrorLog /var/log/apache2/error.log 176 177# 178# LogLevel: Control the number of messages logged to the error_log. 179# Possible values include: debug, info, notice, warn, error, crit, 180# alert, emerg. 181# 182LogLevel warn 183 184# Include module configuration: 185Include /etc/apache2/mods-enabled/*.load 186Include /etc/apache2/mods-enabled/*.conf 187 188# Include all the user configurations: 189Include /etc/apache2/httpd.conf 190 191# Include ports listing 192Include /etc/apache2/ports.conf 193 194# 195# The following directives define some format nicknames for use with 196# a CustomLog directive (see below). 197# If you are behind a reverse proxy, you might want to change %h into %{X-Forwarded-For}i 198# 199LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined 200LogFormat "%h %l %u %t \"%r\" %>s %b" common 201LogFormat "%{Referer}i -> %U" referer 202LogFormat "%{User-agent}i" agent 203 204# 205# ServerTokens 206# This directive configures what you return as the Server HTTP response 207# Header. The default is 'Full' which sends information about the OS-Type 208# and compiled in modules. 209# Set to one of: Full | OS | Minor | Minimal | Major | Prod 210# where Full conveys the most information, and Prod the least. 211# 212ServerTokens Full 213 214# 215# Optionally add a line containing the server version and virtual host 216# name to server-generated pages (internal error documents, FTP directory 217# listings, mod_status and mod_info output etc., but not CGI generated 218# documents or custom error documents). 219# Set to "EMail" to also include a mailto: link to the ServerAdmin. 220# Set to one of: On | Off | EMail 221# 222ServerSignature On 223 224 225 226# 227# Customizable error responses come in three flavors: 228# 1) plain text 2) local redirects 3) external redirects 229# 230# Some examples: 231#ErrorDocument 500 "The server made a boo boo." 232#ErrorDocument 404 /missing.html 233#ErrorDocument 404 "/cgi-bin/missing_handler.pl" 234#ErrorDocument 402 http://www.example.com/subscription_info.html 235# 236 237# 238# Putting this all together, we can internationalize error responses. 239# 240# We use Alias to redirect any /error/HTTP_<error>.html.var response to 241# our collection of by-error message multi-language collections. We use 242# includes to substitute the appropriate text. 243# 244# You can modify the messages' appearance without changing any of the 245# default HTTP_<error>.html.var files by adding the line: 246# 247# Alias /error/include/ "/your/include/path/" 248# 249# which allows you to create your own set of files by starting with the 250# /usr/share/apache2/error/include/ files and copying them to /your/include/path/, 251# even on a per-VirtualHost basis. The default include files will display 252# your Apache version number and your ServerAdmin email address regardless 253# of the setting of ServerSignature. 254# 255# The internationalized error documents require mod_alias, mod_include 256# and mod_negotiation. To activate them, uncomment the following 30 lines. 257 258# Alias /error/ "/usr/share/apache2/error/" 259# 260# <Directory "/usr/share/apache2/error"> 261# AllowOverride None 262# Options IncludesNoExec 263# AddOutputFilter Includes html 264# AddHandler type-map var 265# Order allow,deny 266# Allow from all 267# LanguagePriority en cs de es fr it nl sv pt-br ro 268# ForceLanguagePriority Prefer Fallback 269# </Directory> 270# 271# ErrorDocument 400 /error/HTTP_BAD_REQUEST.html.var 272# ErrorDocument 401 /error/HTTP_UNAUTHORIZED.html.var 273# ErrorDocument 403 /error/HTTP_FORBIDDEN.html.var 274# ErrorDocument 404 /error/HTTP_NOT_FOUND.html.var 275# ErrorDocument 405 /error/HTTP_METHOD_NOT_ALLOWED.html.var 276# ErrorDocument 408 /error/HTTP_REQUEST_TIME_OUT.html.var 277# ErrorDocument 410 /error/HTTP_GONE.html.var 278# ErrorDocument 411 /error/HTTP_LENGTH_REQUIRED.html.var 279# ErrorDocument 412 /error/HTTP_PRECONDITION_FAILED.html.var 280# ErrorDocument 413 /error/HTTP_REQUEST_ENTITY_TOO_LARGE.html.var 281# ErrorDocument 414 /error/HTTP_REQUEST_URI_TOO_LARGE.html.var 282# ErrorDocument 415 /error/HTTP_UNSUPPORTED_MEDIA_TYPE.html.var 283# ErrorDocument 500 /error/HTTP_INTERNAL_SERVER_ERROR.html.var 284# ErrorDocument 501 /error/HTTP_NOT_IMPLEMENTED.html.var 285# ErrorDocument 502 /error/HTTP_BAD_GATEWAY.html.var 286# ErrorDocument 503 /error/HTTP_SERVICE_UNAVAILABLE.html.var 287# ErrorDocument 506 /error/HTTP_VARIANT_ALSO_VARIES.html.var 288 289 290 291# Include of directories ignores editors' and dpkg's backup files, 292# see README.Debian for details. 293 294# Include generic snippets of statements 295Include /etc/apache2/conf.d/ 296 297# Include the virtual host configurations: 298Include /etc/apache2/sites-enabled/ 299 300# For Autotest. 301AddHandler cgi-script .cgi 302