tom@954: # tom@954: # This is the main Apache HTTP server configuration file. It contains the tom@954: # configuration directives that give the server its instructions. tom@954: # See for detailed information. tom@954: # In particular, see tom@954: # tom@954: # for a discussion of each configuration directive. tom@954: # tom@954: # Do NOT simply read the instructions in here without understanding tom@954: # what they do. They're here only as hints or reminders. If you are unsure tom@954: # consult the online docs. You have been warned. tom@954: # tom@954: # Configuration and logfile names: If the filenames you specify for many tom@954: # of the server's control files begin with "/" (or "drive:/" for Win32), the tom@954: # server will use that explicit path. If the filenames do *not* begin tom@954: # with "/", the value of ServerRoot is prepended -- so "logs/access_log" tom@954: # with ServerRoot set to "/usr/local/apache2" will be interpreted by the tom@954: # server as "/usr/local/apache2/logs/access_log", whereas "/logs/access_log" tom@954: # will be interpreted as '/logs/access_log'. tom@954: tom@954: # tom@954: # ServerRoot: The top of the directory tree under which the server's tom@954: # configuration, error, and log files are kept. tom@954: # tom@954: # Do not add a slash at the end of the directory path. If you point tom@954: # ServerRoot at a non-local disk, be sure to specify a local disk on the tom@954: # Mutex directive, if file-based mutexes are used. If you wish to share the tom@954: # same ServerRoot for multiple httpd daemons, you will need to change at tom@954: # least PidFile. tom@954: # tom@954: ServerRoot "/usr/local/apache2" tom@954: tom@954: # tom@954: # Mutex: Allows you to set the mutex mechanism and mutex file directory tom@954: # for individual mutexes, or change the global defaults tom@954: # tom@954: # Uncomment and change the directory if mutexes are file-based and the default tom@954: # mutex file directory is not on a local disk or is not appropriate for some tom@954: # other reason. tom@954: # tom@954: # Mutex default:logs tom@954: tom@954: # tom@954: # Listen: Allows you to bind Apache to specific IP addresses and/or tom@954: # ports, instead of the default. See also the tom@954: # directive. tom@954: # tom@954: # Change this to Listen on specific IP addresses as shown below to tom@954: # prevent Apache from glomming onto all bound IP addresses. tom@954: # tom@954: #Listen 12.34.56.78:80 tom@954: Listen 80 tom@954: tom@954: # tom@954: # Dynamic Shared Object (DSO) Support tom@954: # tom@954: # To be able to use the functionality of a module which was built as a DSO you tom@954: # have to place corresponding `LoadModule' lines at this location so the tom@954: # directives contained in it are actually available _before_ they are used. tom@954: # Statically compiled modules (those listed by `httpd -l') do not need tom@954: # to be loaded here. tom@954: # tom@954: # Example: tom@954: # LoadModule foo_module modules/mod_foo.so tom@954: # tom@954: LoadModule authn_file_module modules/mod_authn_file.so tom@954: #LoadModule authn_dbm_module modules/mod_authn_dbm.so tom@954: #LoadModule authn_anon_module modules/mod_authn_anon.so tom@954: #LoadModule authn_dbd_module modules/mod_authn_dbd.so tom@954: #LoadModule authn_socache_module modules/mod_authn_socache.so tom@954: LoadModule authn_core_module modules/mod_authn_core.so tom@954: LoadModule authz_host_module modules/mod_authz_host.so tom@954: LoadModule authz_groupfile_module modules/mod_authz_groupfile.so tom@954: LoadModule authz_user_module modules/mod_authz_user.so tom@954: #LoadModule authz_dbm_module modules/mod_authz_dbm.so tom@954: #LoadModule authz_owner_module modules/mod_authz_owner.so tom@954: #LoadModule authz_dbd_module modules/mod_authz_dbd.so tom@954: LoadModule authz_core_module modules/mod_authz_core.so tom@954: #LoadModule authnz_ldap_module modules/mod_authnz_ldap.so tom@954: LoadModule access_compat_module modules/mod_access_compat.so tom@954: LoadModule auth_basic_module modules/mod_auth_basic.so tom@954: #LoadModule auth_form_module modules/mod_auth_form.so tom@954: #LoadModule auth_digest_module modules/mod_auth_digest.so tom@954: #LoadModule allowmethods_module modules/mod_allowmethods.so tom@954: #LoadModule file_cache_module modules/mod_file_cache.so tom@954: #LoadModule cache_module modules/mod_cache.so tom@954: #LoadModule cache_disk_module modules/mod_cache_disk.so tom@954: #LoadModule cache_socache_module modules/mod_cache_socache.so tom@954: #LoadModule socache_shmcb_module modules/mod_socache_shmcb.so tom@954: #LoadModule socache_dbm_module modules/mod_socache_dbm.so tom@954: #LoadModule socache_memcache_module modules/mod_socache_memcache.so tom@954: #LoadModule macro_module modules/mod_macro.so tom@954: #LoadModule dbd_module modules/mod_dbd.so tom@954: #LoadModule dumpio_module modules/mod_dumpio.so tom@954: #LoadModule buffer_module modules/mod_buffer.so tom@954: #LoadModule ratelimit_module modules/mod_ratelimit.so tom@954: LoadModule reqtimeout_module modules/mod_reqtimeout.so tom@954: #LoadModule ext_filter_module modules/mod_ext_filter.so tom@954: #LoadModule request_module modules/mod_request.so tom@954: #LoadModule include_module modules/mod_include.so tom@954: LoadModule filter_module modules/mod_filter.so tom@954: #LoadModule substitute_module modules/mod_substitute.so tom@954: #LoadModule sed_module modules/mod_sed.so tom@954: #LoadModule deflate_module modules/mod_deflate.so tom@954: LoadModule mime_module modules/mod_mime.so tom@954: #LoadModule ldap_module modules/mod_ldap.so tom@954: LoadModule log_config_module modules/mod_log_config.so tom@954: #LoadModule log_debug_module modules/mod_log_debug.so tom@954: #LoadModule logio_module modules/mod_logio.so tom@954: LoadModule env_module modules/mod_env.so tom@954: #LoadModule expires_module modules/mod_expires.so tom@954: LoadModule headers_module modules/mod_headers.so tom@954: #LoadModule unique_id_module modules/mod_unique_id.so tom@954: LoadModule setenvif_module modules/mod_setenvif.so tom@954: LoadModule version_module modules/mod_version.so tom@954: #LoadModule remoteip_module modules/mod_remoteip.so tom@954: LoadModule proxy_module modules/mod_proxy.so tom@954: #LoadModule proxy_connect_module modules/mod_proxy_connect.so tom@954: #LoadModule proxy_ftp_module modules/mod_proxy_ftp.so tom@954: LoadModule proxy_http_module modules/mod_proxy_http.so tom@954: #LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so tom@954: #LoadModule proxy_scgi_module modules/mod_proxy_scgi.so tom@954: #LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so tom@954: #LoadModule proxy_ajp_module modules/mod_proxy_ajp.so tom@954: #LoadModule proxy_balancer_module modules/mod_proxy_balancer.so tom@954: #LoadModule proxy_express_module modules/mod_proxy_express.so tom@954: #LoadModule session_module modules/mod_session.so tom@954: #LoadModule session_cookie_module modules/mod_session_cookie.so tom@954: #LoadModule session_crypto_module modules/mod_session_crypto.so tom@954: #LoadModule session_dbd_module modules/mod_session_dbd.so tom@954: #LoadModule slotmem_shm_module modules/mod_slotmem_shm.so tom@954: #LoadModule ssl_module modules/mod_ssl.so tom@954: #LoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so tom@954: #LoadModule lbmethod_bytraffic_module modules/mod_lbmethod_bytraffic.so tom@954: #LoadModule lbmethod_bybusyness_module modules/mod_lbmethod_bybusyness.so tom@954: #LoadModule lbmethod_heartbeat_module modules/mod_lbmethod_heartbeat.so tom@954: LoadModule unixd_module modules/mod_unixd.so tom@954: #LoadModule dav_module modules/mod_dav.so tom@954: LoadModule status_module modules/mod_status.so tom@954: LoadModule autoindex_module modules/mod_autoindex.so tom@954: #LoadModule info_module modules/mod_info.so tom@954: #LoadModule cgid_module modules/mod_cgid.so tom@954: #LoadModule dav_fs_module modules/mod_dav_fs.so tom@954: #LoadModule vhost_alias_module modules/mod_vhost_alias.so tom@954: #LoadModule negotiation_module modules/mod_negotiation.so tom@954: LoadModule dir_module modules/mod_dir.so tom@954: #LoadModule actions_module modules/mod_actions.so tom@954: #LoadModule speling_module modules/mod_speling.so tom@954: #LoadModule userdir_module modules/mod_userdir.so tom@954: LoadModule alias_module modules/mod_alias.so tom@954: #LoadModule rewrite_module modules/mod_rewrite.so tom@954: tom@954: tom@954: # tom@954: # If you wish httpd to run as a different user or group, you must run tom@954: # httpd as root initially and it will switch. tom@954: # tom@954: # User/Group: The name (or #number) of the user/group to run httpd as. tom@954: # It is usually good practice to create a dedicated user and group for tom@954: # running httpd, as with most system services. tom@954: # tom@954: User daemon tom@954: Group daemon tom@954: tom@954: tom@954: tom@954: # 'Main' server configuration tom@954: # tom@954: # The directives in this section set up the values used by the 'main' tom@954: # server, which responds to any requests that aren't handled by a tom@954: # definition. These values also provide defaults for tom@954: # any containers you may define later in the file. tom@954: # tom@954: # All of these directives may appear inside containers, tom@954: # in which case these default settings will be overridden for the tom@954: # virtual host being defined. tom@954: # tom@954: tom@954: # tom@954: # ServerAdmin: Your address, where problems with the server should be tom@954: # e-mailed. This address appears on some server-generated pages, such tom@954: # as error documents. e.g. admin@your-domain.com tom@954: # tom@954: ServerAdmin you@example.com tom@954: tom@954: # tom@954: # ServerName gives the name and port that the server uses to identify itself. tom@954: # This can often be determined automatically, but we recommend you specify tom@954: # it explicitly to prevent problems during startup. tom@954: # tom@954: # If your host doesn't have a registered DNS name, enter its IP address here. tom@954: # tom@954: #ServerName www.example.com:80 tom@954: tom@954: # tom@954: # Deny access to the entirety of your server's filesystem. You must tom@954: # explicitly permit access to web content directories in other tom@954: # blocks below. tom@954: # tom@954: tom@954: AllowOverride none tom@954: Require all denied tom@954: tom@954: tom@954: # tom@954: # Note that from this point forward you must specifically allow tom@954: # particular features to be enabled - so if something's not working as tom@954: # you might expect, make sure that you have specifically enabled it tom@954: # below. tom@954: # tom@954: tom@954: # tom@954: # DocumentRoot: The directory out of which you will serve your tom@954: # documents. By default, all requests are taken from this directory, but tom@954: # symbolic links and aliases may be used to point to other locations. tom@954: # tom@954: DocumentRoot "/usr/local/apache2/htdocs" tom@954: tom@954: # tom@954: # Possible values for the Options directive are "None", "All", tom@954: # or any combination of: tom@954: # Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews tom@954: # tom@954: # Note that "MultiViews" must be named *explicitly* --- "Options All" tom@954: # doesn't give it to you. tom@954: # tom@954: # The Options directive is both complicated and important. Please see tom@954: # http://httpd.apache.org/docs/2.4/mod/core.html#options tom@954: # for more information. tom@954: # tom@954: Options Indexes FollowSymLinks tom@954: tom@954: # tom@954: # AllowOverride controls what directives may be placed in .htaccess files. tom@954: # It can be "All", "None", or any combination of the keywords: tom@954: # AllowOverride FileInfo AuthConfig Limit tom@954: # tom@954: AllowOverride None tom@954: tom@954: # tom@954: # Controls who can get stuff from this server. tom@954: # tom@954: Require all granted tom@954: tom@954: tom@954: # tom@954: # DirectoryIndex: sets the file that Apache will serve if a directory tom@954: # is requested. tom@954: # tom@954: tom@954: DirectoryIndex index.html tom@954: tom@954: tom@954: # tom@954: # The following lines prevent .htaccess and .htpasswd files from being tom@954: # viewed by Web clients. tom@954: # tom@954: tom@954: Require all denied tom@954: tom@954: tom@954: # tom@954: # ErrorLog: The location of the error log file. tom@954: # If you do not specify an ErrorLog directive within a tom@954: # container, error messages relating to that virtual host will be tom@954: # logged here. If you *do* define an error logfile for a tom@954: # container, that host's errors will be logged there and not here. tom@954: # tom@954: ErrorLog /proc/self/fd/2 tom@954: tom@954: # tom@954: # LogLevel: Control the number of messages logged to the error_log. tom@954: # Possible values include: debug, info, notice, warn, error, crit, tom@954: # alert, emerg. tom@954: # tom@954: LogLevel warn tom@954: tom@954: tom@954: # tom@954: # The following directives define some format nicknames for use with tom@954: # a CustomLog directive (see below). tom@954: # tom@954: LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined tom@954: LogFormat "%h %l %u %t \"%r\" %>s %b" common tom@954: tom@954: tom@954: # You need to enable mod_logio.c to use %I and %O tom@954: LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio tom@954: tom@954: tom@954: # tom@954: # The location and format of the access logfile (Common Logfile Format). tom@954: # If you do not define any access logfiles within a tom@954: # container, they will be logged here. Contrariwise, if you *do* tom@954: # define per- access logfiles, transactions will be tom@954: # logged therein and *not* in this file. tom@954: # tom@954: CustomLog /proc/self/fd/1 common tom@954: tom@954: # tom@954: # If you prefer a logfile with access, agent, and referer information tom@954: # (Combined Logfile Format) you can use the following directive. tom@954: # tom@954: #CustomLog "logs/access_log" combined tom@954: tom@954: tom@954: tom@954: # tom@954: # Redirect: Allows you to tell clients about documents that used to tom@954: # exist in your server's namespace, but do not anymore. The client tom@954: # will make a new request for the document at its new location. tom@954: # Example: tom@954: # Redirect permanent /foo http://www.example.com/bar tom@954: tom@954: # tom@954: # Alias: Maps web paths into filesystem paths and is used to tom@954: # access content that does not live under the DocumentRoot. tom@954: # Example: tom@954: # Alias /webpath /full/filesystem/path tom@954: # tom@954: # If you include a trailing / on /webpath then the server will tom@954: # require it to be present in the URL. You will also likely tom@954: # need to provide a section to allow access to tom@954: # the filesystem path. tom@954: tom@954: # tom@954: # ScriptAlias: This controls which directories contain server scripts. tom@954: # ScriptAliases are essentially the same as Aliases, except that tom@954: # documents in the target directory are treated as applications and tom@954: # run by the server when requested rather than as documents sent to the tom@954: # client. The same rules about trailing "/" apply to ScriptAlias tom@954: # directives as to Alias. tom@954: # tom@954: ScriptAlias /cgi-bin/ "/usr/local/apache2/cgi-bin/" tom@954: tom@954: tom@954: tom@954: tom@954: # tom@954: # ScriptSock: On threaded servers, designate the path to the UNIX tom@954: # socket used to communicate with the CGI daemon of mod_cgid. tom@954: # tom@954: #Scriptsock cgisock tom@954: tom@954: tom@954: # tom@954: # "/usr/local/apache2/cgi-bin" should be changed to whatever your ScriptAliased tom@954: # CGI directory exists, if you have that configured. tom@954: # tom@954: tom@954: AllowOverride None tom@954: Options None tom@954: Require all granted tom@954: tom@954: tom@954: tom@954: # tom@954: # TypesConfig points to the file containing the list of mappings from tom@954: # filename extension to MIME-type. tom@954: # tom@954: TypesConfig conf/mime.types tom@954: tom@954: # tom@954: # AddType allows you to add to or override the MIME configuration tom@954: # file specified in TypesConfig for specific file types. tom@954: # tom@954: #AddType application/x-gzip .tgz tom@954: # tom@954: # AddEncoding allows you to have certain browsers uncompress tom@954: # information on the fly. Note: Not all browsers support this. tom@954: # tom@954: #AddEncoding x-compress .Z tom@954: #AddEncoding x-gzip .gz .tgz tom@954: # tom@954: # If the AddEncoding directives above are commented-out, then you tom@954: # probably should define those extensions to indicate media types: tom@954: # tom@954: AddType application/x-compress .Z tom@954: AddType application/x-gzip .gz .tgz tom@954: tom@954: # tom@954: # AddHandler allows you to map certain file extensions to "handlers": tom@954: # actions unrelated to filetype. These can be either built into the server tom@954: # or added with the Action directive (see below) tom@954: # tom@954: # To use CGI scripts outside of ScriptAliased directories: tom@954: # (You will also need to add "ExecCGI" to the "Options" directive.) tom@954: # tom@954: #AddHandler cgi-script .cgi tom@954: tom@954: # For type maps (negotiated resources): tom@954: #AddHandler type-map var tom@954: tom@954: # tom@954: # Filters allow you to process content before it is sent to the client. tom@954: # tom@954: # To parse .shtml files for server-side includes (SSI): tom@954: # (You will also need to add "Includes" to the "Options" directive.) tom@954: # tom@954: #AddType text/html .shtml tom@954: #AddOutputFilter INCLUDES .shtml tom@954: tom@954: tom@954: # tom@954: # The mod_mime_magic module allows the server to use various hints from the tom@954: # contents of the file itself to determine its type. The MIMEMagicFile tom@954: # directive tells the module where the hint definitions are located. tom@954: # tom@954: #MIMEMagicFile conf/magic tom@954: tom@954: # tom@954: # Customizable error responses come in three flavors: tom@954: # 1) plain text 2) local redirects 3) external redirects tom@954: # tom@954: # Some examples: tom@954: #ErrorDocument 500 "The server made a boo boo." tom@954: #ErrorDocument 404 /missing.html tom@954: #ErrorDocument 404 "/cgi-bin/missing_handler.pl" tom@954: #ErrorDocument 402 http://www.example.com/subscription_info.html tom@954: # tom@954: tom@954: # tom@954: # MaxRanges: Maximum number of Ranges in a request before tom@954: # returning the entire resource, or one of the special tom@954: # values 'default', 'none' or 'unlimited'. tom@954: # Default setting is to accept 200 Ranges. tom@954: #MaxRanges unlimited tom@954: tom@954: # tom@954: # EnableMMAP and EnableSendfile: On systems that support it, tom@954: # memory-mapping or the sendfile syscall may be used to deliver tom@954: # files. This usually improves server performance, but must tom@954: # be turned off when serving from networked-mounted tom@954: # filesystems or if support for these functions is otherwise tom@954: # broken on your system. tom@954: # Defaults: EnableMMAP On, EnableSendfile Off tom@954: # tom@954: #EnableMMAP off tom@954: #EnableSendfile on tom@954: tom@954: # Supplemental configuration tom@954: # tom@954: # The configuration files in the conf/extra/ directory can be tom@954: # included to add extra features or to modify the default configuration of tom@954: # the server, or you may simply copy their contents here and change as tom@954: # necessary. tom@954: tom@954: # Server-pool management (MPM specific) tom@954: #Include conf/extra/httpd-mpm.conf tom@954: tom@954: # Multi-language error messages tom@954: #Include conf/extra/httpd-multilang-errordoc.conf tom@954: tom@954: # Fancy directory listings tom@954: #Include conf/extra/httpd-autoindex.conf tom@954: tom@954: # Language settings tom@954: #Include conf/extra/httpd-languages.conf tom@954: tom@954: # User home directories tom@954: #Include conf/extra/httpd-userdir.conf tom@954: tom@954: # Real-time info on requests and configuration tom@954: #Include conf/extra/httpd-info.conf tom@954: tom@954: # Virtual hosts tom@954: Include conf/extra/httpd-vhosts.conf tom@954: tom@954: # Local access to the Apache HTTP Server Manual tom@954: #Include conf/extra/httpd-manual.conf tom@954: tom@954: # Distributed authoring and versioning (WebDAV) tom@954: #Include conf/extra/httpd-dav.conf tom@954: tom@954: # Various default settings tom@954: #Include conf/extra/httpd-default.conf tom@954: tom@954: # Configure mod_proxy_html to understand HTML4/XHTML1 tom@954: tom@954: Include conf/extra/proxy-html.conf tom@954: tom@954: tom@954: # Secure (SSL/TLS) connections tom@954: #Include conf/extra/httpd-ssl.conf tom@954: # tom@954: # Note: The following must must be present to support tom@954: # starting without SSL on platforms with no /dev/random equivalent tom@954: # but a statically compiled-in mod_ssl. tom@954: # tom@954: tom@954: SSLRandomSeed startup builtin tom@954: SSLRandomSeed connect builtin tom@954: tom@954: # tom@954: # uncomment out the below to deal with user agents that deliberately tom@954: # violate open standards by misusing DNT (DNT *must* be a specific tom@954: # end-user choice) tom@954: # tom@954: # tom@954: #BrowserMatch "MSIE 10.0;" bad_DNT tom@954: # tom@954: # tom@954: #RequestHeader unset DNT env=bad_DNT tom@954: #