2 ## httpd.conf -- Apache HTTP server configuration file
5 ##### Global Environment
6 # The directives in this section affect the overall operation of Apache,
7 # such as the number of concurrent requests it can handle or where it can
8 # find its configuration files.
11 # is either inetd, or standalone. Inetd mode is only supported on Unix
17 # The file in which the server should record its process identification
18 # number when it starts.
20 PidFile /var/run/httpd.pid
23 # The number of seconds before receives and sends time out.
25 # Number of seconds to wait for the next request from the same client on the
32 # Whether or not to allow persistent connections (more than one request per
33 # connection). Set to "Off" to deactivate.
34 ### MaxKeepAliveRequests
35 # The maximum number of requests to allow during a persistent connection.
36 # Set to 0 to allow an unlimited amount. We recommend you leave this number
37 # high, for maximum performance.
40 MaxKeepAliveRequests 100
43 # The top of the directory tree under which the server's configuration,
44 # error, and log files are kept.
46 # NOTE! If you intend to place this on an NFS (or otherwise network)
47 # mounted filesystem then please read the LockFile documentation
48 # (available at <URL:http://www.apache.org/docs/mod/core.html#lockfile>);
49 # you will save yourself a lot of trouble.
51 # Do NOT add a slash at the end of the directory path.
56 # The LockFile directive sets the path to the lockfile used when Apache
57 # is compiled with either USE_FCNTL_SERIALIZED_ACCEPT or
58 # USE_FLOCK_SERIALIZED_ACCEPT. This directive should normally be left at
59 # its default value. The main reason for changing it is if the logs
60 # directory is NFS mounted, since the lockfile MUST BE STORED ON A LOCAL
61 # DISK. The PID of the main server process is automatically appended to
64 LockFile /var/run/httpd.lock
67 # File used to store internal server process information. Not all
68 # architectures require this. But if yours does (you'll know because this
69 # file will be created when you run Apache) then you *must* ensure that no
70 # two invocations of Apache share the same scoreboard file.
72 ScoreBoardFile /var/run/httpd.scoreboard
75 # In the standard configuration, the server will process this file,
76 # srm.conf, and access.conf in that order. The latter two files are
77 # now distributed empty, as it is recommended that all directives
78 # be kept in a single file for simplicity. The commented-out values
79 # below are the built-in defaults. You can have the server ignore
80 # these files altogether by using "/dev/null" (for Unix) or
81 # "nul" (for Win32) for the arguments to the directives.
83 ResourceConfig /dev/null
84 AccessConfig /dev/null
87 # Server-pool size regulation. Rather than making you guess how many
88 # server processes you need, Apache dynamically adapts to the load it
89 # sees --- that is, it tries to maintain enough server processes to
90 # handle the current load, plus a few spare servers to handle transient
91 # load spikes (e.g., multiple simultaneous requests from a single
94 # It does this by periodically checking how many servers are waiting
95 # for a request. If there are fewer than MinSpareServers, it creates
96 # a new spare. If there are more than MaxSpareServers, some of the
97 # spares die off. The default values are probably OK for most sites.
103 # Number of servers to start initially --- should be a reasonable ballpark
109 # Limit on total number of servers running, i.e., limit on the number
110 # of clients who can simultaneously connect --- if this limit is ever
111 # reached, clients will be LOCKED OUT, so it should NOT BE SET TOO LOW.
112 # It is intended mainly as a brake to keep a runaway server from taking
113 # the system with it as it spirals down...
118 # MaxRequestsPerChild: the number of requests each child process is
119 # allowed to process before the child dies. The child will exit so
120 # as to avoid problems after prolonged use when Apache (and maybe the
121 # libraries it uses) leak memory or other resources. On most systems, this
122 # isn't really needed, but a few (such as Solaris) do have notable leaks
123 # in the libraries. For these platforms, set to something like 10000
124 # or so; a setting of 0 means unlimited.
126 # NOTE: This value does not include keepalive requests after the initial
127 # request per connection. For example, if a child process handles
128 # an initial request and 10 subsequent "keptalive" requests, it
129 # would only count as 1 request towards this limit.
131 MaxRequestsPerChild 30
134 # Allows you to bind Apache to specific IP addresses and/or ports, in
135 # addition to the default. See also the <VirtualHost> directive.
137 #Listen 12.34.56.78:80
140 # Listen can take two arguments.
141 # (this is an extension for supporting IPv6 addresses)
146 # You can support virtual hosts with this option. This directive is used to
147 # tell the server which IP address to listen to. It can either contain "*",
148 # an IP address, or a fully qualified Internet domain name. See also the
149 # <VirtualHost> and Listen directives.
154 # controls whether Apache will generate "full" status information
155 # (ExtendedStatus On) or just basic information (ExtendedStatus Off) when
156 # the "server-status" handler is called. The default is Off.
160 ### Section 2: Dynamic Shared Object (DSO) Support
163 # LoadModule foo_module libexec/mod_foo.so
165 # Reconstruction of the complete module list from all available modules
166 # (static and shared ones) to achieve correct module execution order.
167 # [WHENEVER YOU CHANGE THE LOADMODULE SECTION ABOVE UPDATE THIS, TOO]
171 ### Section 3: 'Main' server configuration
173 # The directives in this section set up the values used by the 'main'
174 # server, which responds to any requests that aren't handled by a
175 # <VirtualHost> definition. These values also provide defaults for
176 # any <VirtualHost> containers you may define later in the file.
178 # All of these directives may appear inside <VirtualHost> containers,
179 # in which case these default settings will be overridden for the
180 # virtual host being defined.
184 # If your ServerType directive (set earlier in the 'Global Environment'
185 # section) is set to "inetd", the next few directives don't have any
186 # effect since their settings are defined by the inetd configuration.
187 # Skip ahead to the ServerAdmin directive.
191 # Port: The port to which the standalone server listens. For
192 # ports < 1023, you will need httpd to be run as root initially.
197 # If you wish httpd to run as a different user or group, you must run
198 # httpd as root initially and it will switch.
204 # ServerAdmin: Your address, where problems with the server should be
205 # e-mailed. This address appears on some server-generated pages, such
206 # as error documents.
208 ServerAdmin admin@your_domain.org
211 # ServerName allows you to set a host name which is sent back to clients for
212 # your server if it's different than the one the program would get (i.e., use
213 # "www" instead of the host's real name).
215 # Note: You cannot just invent host names and hope they work. The name you
216 # define here must be a valid DNS name for your host. If you don't understand
217 # this, ask your network administrator.
218 # If your host doesn't have a registered DNS name, enter its IP address here.
219 # You will have to access it by its address (e.g., http://123.45.67.89/)
220 # anyway, and this will make redirections work in a sensible way.
222 # 127.0.0.1 is the TCP/IP local loop-back address, often named localhost. Your
223 # machine always knows itself by this address. If you use Apache strictly for
224 # local testing and development, you may use 127.0.0.1 as the server name.
226 #ServerName new.host.name
229 # DocumentRoot: The directory out of which you will serve your
230 # documents. By default, all requests are taken from this directory, but
231 # symbolic links and aliases may be used to point to other locations.
233 DocumentRoot "/home/httpd/html"
236 # Each directory to which Apache has access, can be configured with respect
237 # to which services and features are allowed and/or disabled in that
238 # directory (and its subdirectories).
240 # First, we configure the "default" to be a very restrictive set of
244 Options FollowSymLinks
249 # Note that from this point forward you must specifically allow
250 # particular features to be enabled - so if something's not working as
251 # you might expect, make sure that you have specifically enabled it
256 # This should be changed to whatever you set DocumentRoot to.
258 <Directory "/home/httpd/html">
261 # This may also be "None", "All", or any combination of "Indexes",
262 # "Includes", "FollowSymLinks", "ExecCGI", or "MultiViews".
264 # Note that "MultiViews" must be named *explicitly* --- "Options All"
265 # doesn't give it to you.
267 Options Indexes FollowSymLinks MultiViews
270 # This controls which options the .htaccess files in directories can
271 # override. Can also be "All", or any combination of "Options", "FileInfo",
272 # "AuthConfig", and "Limit"
277 # Controls who can get stuff from this server.
284 # UserDir: The name of the directory which is appended onto a user's home
285 # directory if a ~user request is received.
290 # Control access to UserDir directories. The following is an example
291 # for a site where these directories are restricted to read-only.
293 #<Directory /home/*/public_html>
294 # AllowOverride FileInfo AuthConfig Limit
295 # Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
296 # <Limit GET POST OPTIONS PROPFIND>
300 # <LimitExcept GET POST OPTIONS PROPFIND>
307 # DirectoryIndex: Name of the file or files to use as a pre-written HTML
308 # directory index. Separate multiple entries with spaces.
311 DirectoryIndex index.html index.htm index.shtml index.cgi index.php
315 # AccessFileName: The name of the file to look for in each directory
316 # for access control information.
318 AccessFileName .htaccess
321 # The following lines prevent .htaccess files from being viewed by
322 # Web clients. Since .htaccess files often contain authorization
323 # information, access is disallowed for security reasons. Comment
324 # these lines out if you want Web visitors to see the contents of
325 # .htaccess files. If you change the AccessFileName directive above,
326 # be sure to make the corresponding changes here.
328 # Also, folks tend to use names such as .htpasswd for password
329 # files, so this will protect those as well.
337 # CacheNegotiatedDocs: By default, Apache sends "Pragma: no-cache" with each
338 # document that was negotiated on the basis of content. This asks proxy
339 # servers not to cache the document. Uncommenting the following line disables
340 # this behavior, and proxies will be allowed to cache the documents.
345 # UseCanonicalName: (new for 1.3) With this setting turned on, whenever
346 # Apache needs to construct a self-referencing URL (a URL that refers back
347 # to the server the response is coming from) it will use ServerName and
348 # Port to form a "canonical" name. With this setting off, Apache will
349 # use the hostname:port that the client supplied, when possible. This
350 # also affects SERVER_NAME and SERVER_PORT in CGI scripts.
355 # TypesConfig describes where the mime.types file (or equivalent) is
356 # to be found. /etc/mime.types is provided by mailcap package.
358 TypesConfig /etc/mime.types
361 # DefaultType is the default MIME type the server will use for a document
362 # if it cannot otherwise determine one, such as from filename extensions.
363 # If your server contains mostly text or HTML documents, "text/plain" is
364 # a good value. If most of your content is binary, such as applications
365 # or images, you may want to use "application/octet-stream" instead to
366 # keep browsers from trying to display binary files as though they are
369 DefaultType text/plain
372 # The mod_mime_magic module allows the server to use various hints from the
373 # contents of the file itself to determine its type. The MIMEMagicFile
374 # directive tells the module where the hint definitions are located.
375 # mod_mime_magic is not part of the default server (you have to add
376 # it yourself with a LoadModule [see the DSO paragraph in the 'Global
377 # Environment' section], or recompile the server and include mod_mime_magic
378 # as part of the configuration), so it's enclosed in an <IfModule> container.
379 # This means that the MIMEMagicFile directive will only be processed if the
380 # module is part of the server.
382 <IfModule mod_mime_magic.c>
383 MIMEMagicFile /etc/httpd/magic
387 # HostnameLookups: Log the names of clients or just their IP addresses
388 # e.g., www.apache.org (on) or 204.62.129.132 (off).
389 # The default is off because it'd be overall better for the net if people
390 # had to knowingly turn this feature on, since enabling it means that
391 # each client request will result in AT LEAST one lookup request to the
397 # The following directives define some format nicknames for use with
398 # a CustomLog directive (see below).
400 LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
401 LogFormat "%h %l %u %t \"%r\" %>s %b" common
402 LogFormat "%{Referer}i -> %U" referer
403 LogFormat "%{User-agent}i" agent
406 # ErrorLog: The location of the error log file.
407 # If you do not specify an ErrorLog directive within a <VirtualHost>
408 # container, error messages relating to that virtual host will be
409 # logged here. If you *do* define an error logfile for a <VirtualHost>
410 # container, that host's errors will be logged there and not here.
412 ErrorLog /var/log/httpd/error_log
414 # The location and format of the access logfile (Common Logfile Format).
415 # If you do not define any access logfiles within a <VirtualHost>
416 # container, they will be logged here. Contrariwise, if you *do*
417 # define per-<VirtualHost> access logfiles, transactions will be
418 # logged therein and *not* in this file.
420 CustomLog /var/log/httpd/access_log common
421 CustomLog /var/log/httpd/referer_log referer
422 CustomLog /var/log/httpd/agent_log agent
425 # LogLevel: Control the number of messages logged to the error_log.
426 # Possible values include: debug, info, notice, warn, error, crit,
432 # Optionally add a line containing the server version and virtual host
433 # name to server-generated pages (error documents, FTP directory listings,
434 # mod_status and mod_info output etc., but not CGI generated documents).
435 # Set to "EMail" to also include a mailto: link to the ServerAdmin.
436 # Set to one of: On | Off | EMail
438 ServerSignature Email
441 # Aliases: Add here as many aliases as you need (with no limit). The format is
442 # Alias fakename realname
444 # Note that if you include a trailing / on fakename then the server will
445 # require it to be present in the URL. So "/icons" isn't aliased in this
446 # example, only "/icons/"..
448 Alias /icons/ "/home/httpd/icons/"
450 <Directory "/home/httpd/icons">
451 Options Indexes MultiViews
458 # ScriptAlias: This controls which directories contain server scripts.
459 # ScriptAliases are essentially the same as Aliases, except that
460 # documents in the realname directory are treated as applications and
461 # run by the server when requested rather than as documents sent to the client.
462 # The same rules about trailing "/" apply to ScriptAlias directives as to
465 ScriptAlias /cgi-bin/ "/home/httpd/cgi-bin/"
468 # "/home/httpd/cgi-bin" should be changed to whatever your ScriptAliased
469 # CGI directory exists, if you have that configured.
471 <Directory "/home/httpd/cgi-bin">
479 # Redirect allows you to tell clients about documents which used to exist in
480 # your server's namespace, but do not anymore. This allows you to tell the
481 # clients where to look for the relocated document.
482 # Format: Redirect old-URI new-URL
486 # Directives controlling the display of server-generated directory listings.
490 # FancyIndexing is whether you want fancy directory indexing or standard
492 IndexOptions FancyIndexing
495 # AddIcon* directives tell the server which icon to show for different
496 # files or filename extensions. These are only displayed for
497 # FancyIndexed directories.
499 AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
501 AddIconByType (TXT,/icons/text.gif) text/*
502 AddIconByType (IMG,/icons/image2.gif) image/*
503 AddIconByType (SND,/icons/sound2.gif) audio/*
504 AddIconByType (VID,/icons/movie.gif) video/*
506 AddIcon /icons/binary.gif .bin .exe
507 AddIcon /icons/binhex.gif .hqx
508 AddIcon /icons/tar.gif .tar
509 AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
510 AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
511 AddIcon /icons/a.gif .ps .ai .eps
512 AddIcon /icons/layout.gif .html .shtml .htm .pdf
513 AddIcon /icons/text.gif .txt
514 AddIcon /icons/c.gif .c
515 AddIcon /icons/p.gif .pl .py
516 AddIcon /icons/f.gif .for
517 AddIcon /icons/dvi.gif .dvi
518 AddIcon /icons/uuencoded.gif .uu
519 AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
520 AddIcon /icons/tex.gif .tex
521 AddIcon /icons/bomb.gif core
523 AddIcon /icons/back.gif ..
524 AddIcon /icons/hand.right.gif README
525 AddIcon /icons/folder.gif ^^DIRECTORY^^
526 AddIcon /icons/blank.gif ^^BLANKICON^^
529 # DefaultIcon is which icon to show for files which do not have an icon
532 DefaultIcon /icons/unknown.gif
535 # AddDescription allows you to place a short description after a file in
536 # server-generated indexes. These are only displayed for FancyIndexed
538 # Format: AddDescription "description" filename
540 AddDescription "GZIP compressed document" .gz
541 AddDescription "tar archive" .tar
542 AddDescription "GZIP compressed tar archive" .tgz
545 # ReadmeName is the name of the README file the server will look for by
546 # default, and append to directory listings.
548 # HeaderName is the name of a file which should be prepended to
551 # If MultiViews are amongst the Options in effect, the server will
552 # first look for name.html and include it if found. If name.html
553 # doesn't exist, the server will then look for name.txt and include
554 # it as plaintext if found.
560 # IndexIgnore is a set of filenames which directory indexing should ignore
561 # and not include in the listing. Shell-style wildcarding is permitted.
563 IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
566 # AddEncoding allows you to have certain browsers (Mosaic/X 2.1+) uncompress
567 # information on the fly. Note: Not all browsers support this.
568 # Despite the name similarity, the following Add* directives have nothing
569 # to do with the FancyIndexing customization directives above.
571 AddEncoding x-compress Z
572 AddEncoding x-gzip gz
575 # AddLanguage allows you to specify the language of a document. You can
576 # then use content negotiation to give a browser a file in a language
579 # Note 1: The suffix does not have to be the same as the language
580 # keyword --- those with documents in Polish (whose net-standard
581 # language code is pl) may wish to use "AddLanguage pl .po" to
582 # avoid the ambiguity with the common suffix for perl scripts.
584 # Note 2: The example entries below illustrate that in quite
585 # some cases the two character 'Language' abbriviation is not
586 # identical to the two character 'Country' code for its country,
587 # E.g. 'Danmark/dk' versus 'Danish/da'.
589 # Note 3: In the case of 'ltz' we violate the RFC by using a three char
590 # specifier. But there is 'work in progress' to fix this and get
591 # the reference data for rfc1766 cleaned up.
593 # Danish (da) - Dutch (nl) - English (en) - Estonian (ee)
594 # French (fr) - German (de) - Greek-Modern (el)
595 # Italian (it) - Korean (kr) - Norwegian (no)
596 # Portugese (pt) - Luxembourgeois* (ltz)
597 # Spanish (es) - Swedish (sv) - Catalan (ca) - Czech(cz)
598 # Polish (pl) - Brazilian Portuguese (pt-br) - Japanese (ja)
619 AddLanguage pt-br .pt-br
624 AddCharset Big5 .Big5 .big5
625 AddCharset CP866 .cp866
626 AddCharset ISO-8859-2 .iso-pl
627 AddCharset ISO-8859-5 .iso-ru
628 AddCharset ISO-8859-8 .iso8859-8
629 AddCharset ISO-2022-JP .his
630 AddCharset ISO-2022-KR .iso-kr
631 AddCharset KOI8-R .koi8-r
632 AddCharset UCS-2 .ucs2
633 AddCharset UCS-4 .ucs4
634 AddCharset UTF-8 .utf8
635 AddCharset WINDOWS-1251 .cp-1251
638 # LanguagePriority allows you to give precedence to some languages
639 # in case of a tie during content negotiation.
640 # Just list the languages in decreasing order of preference.
642 LanguagePriority en pl fr de
645 # AddType allows you to tweak mime.types without actually editing it, or to
646 # make certain files to be certain types.
648 # For example, the PHP 3.x module (not part of the Apache distribution - see
649 # http://www.php.net) will typically use:
651 #AddType application/x-httpd-php3 .php3
652 #AddType application/x-httpd-php3-source .phps
654 # And for PHP 4.x, use:
656 #AddType application/x-httpd-php .php
657 #AddType application/x-httpd-php-source .phps
659 #AddType application/x-tar .tgz
662 # AddHandler allows you to map certain file extensions to "handlers",
663 # actions unrelated to filetype. These can be either built into the server
664 # or added with the Action command (see below)
666 # If you want to use server side includes, or CGI outside
667 # ScriptAliased directories, uncomment the following lines.
669 # To use CGI scripts:
671 AddHandler cgi-script .cgi
674 # To use server-parsed HTML files
676 AddType text/html .shtml
677 AddHandler server-parsed .shtml
680 # Uncomment the following line to enable Apache's send-asis HTTP file
683 AddHandler send-as-is asis
686 # If you wish to use server-parsed imagemap files, use
688 AddHandler imap-file map
691 # To enable type maps, you might want to use
693 AddHandler type-map var
696 # Action lets you define media types that will execute a script whenever
697 # a matching file is called. This eliminates the need for repeated URL
698 # pathnames for oft-used CGI file processors.
699 # Format: Action media/type /cgi-script/location
700 # Format: Action handler-name /cgi-script/location
704 # MetaDir: specifies the name of the directory in which Apache can find
705 # meta information files. These files contain additional HTTP headers
706 # to include when sending the document
711 # MetaSuffix: specifies the file name suffix for the file containing the
717 # Customizable error response (Apache style)
718 # these come in three flavors
721 #ErrorDocument 500 "The server made a boo boo.
722 # n.b. the (") marks it as text, it does not get output
725 #ErrorDocument 404 /missing.html
726 # to redirect to local URL /missing.html
727 #ErrorDocument 404 /cgi-bin/missing_handler.pl
728 # N.B.: You can redirect to a script or a document using server-side-includes.
730 # 3) external redirects
731 #ErrorDocument 402 http://some.other_server.com/subscription_info.html
732 # N.B.: Many of the environment variables associated with the original
733 # request will *not* be available to such a script.
735 Alias /errordocs/ "/home/httpd/errordocs/"
737 <Directory /home/httpd/errordocs/>
739 Options IncludesNoExec FollowSymLinks
742 ErrorDocument 400 /errordocs/400.shtml
743 ErrorDocument 401 /errordocs/401.shtml
744 ErrorDocument 403 /errordocs/403.shtml
745 ErrorDocument 404 /errordocs/404.shtml
746 ErrorDocument 405 /errordocs/405.shtml
747 ErrorDocument 406 /errordocs/406.shtml
748 ErrorDocument 408 /errordocs/408.shtml
749 ErrorDocument 410 /errordocs/410.shtml
750 ErrorDocument 411 /errordocs/411.shtml
751 ErrorDocument 414 /errordocs/414.shtml
752 ErrorDocument 500 /errordocs/500.shtml
753 ErrorDocument 503 /errordocs/503.shtml
755 # The following directives modify normal HTTP response behavior.
756 # The first directive disables keepalive for Netscape 2.x and browsers that
757 # spoof it. There are known problems with these browser implementations.
758 # The second directive is for Microsoft Internet Explorer 4.0b2
759 # which has a broken HTTP/1.1 implementation and does not properly
760 # support keepalive when it is used on 301 or 302 (redirect) responses.
762 BrowserMatch "Mozilla/2" nokeepalive
763 BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
766 # The following directive disables HTTP/1.1 responses to browsers which
767 # are in violation of the HTTP/1.0 spec by not being able to grok a
768 # basic 1.1 response.
770 BrowserMatch "RealPlayer 4\.0" force-response-1.0
771 BrowserMatch "Java/1\.0" force-response-1.0
772 BrowserMatch "JDK/1\.0" force-response-1.0
775 # Allow remote server configuration reports, with the URL of
776 # http://servername/server-info (requires that mod_info.c be loaded).
777 # Change the ".your_domain.com" to match your domain to enable.
779 #<Location /server-info>
780 # SetHandler server-info
783 # Allow from .your_domain.com
787 # There have been reports of people trying to abuse an old bug from pre-1.1
788 # days. This bug involved a CGI script distributed as a part of Apache.
789 # By uncommenting these lines you can redirect these attacks to a logging
790 # script on phf.apache.org. Or, you can record them yourself, using the script
791 # support/phf_abuse_log.cgi.
793 #<Location /cgi-bin/phf*>
795 # ErrorDocument 403 http://phf.apache.org/phf_abuse_log.cgi