rdudyala | b086cf3 | 2016-08-11 00:07:45 -0400 | [diff] [blame] | 1 | # This is the main Apache server configuration file. It contains the |
| 2 | # configuration directives that give the server its instructions. |
| 3 | # See http://httpd.apache.org/docs/2.4/ for detailed information about |
| 4 | # the directives and /usr/share/doc/apache2/README.Debian about Debian specific |
| 5 | # hints. |
| 6 | # |
| 7 | # |
| 8 | # Summary of how the Apache 2 configuration works in Debian: |
| 9 | # The Apache 2 web server configuration in Debian is quite different to |
| 10 | # upstream's suggested way to configure the web server. This is because Debian's |
| 11 | # default Apache2 installation attempts to make adding and removing modules, |
| 12 | # virtual hosts, and extra configuration directives as flexible as possible, in |
| 13 | # order to make automating the changes and administering the server as easy as |
| 14 | # possible. |
| 15 | |
| 16 | # It is split into several files forming the configuration hierarchy outlined |
| 17 | # below, all located in the /etc/apache2/ directory: |
| 18 | # |
| 19 | # /etc/apache2/ |
| 20 | # |-- apache2.conf |
| 21 | # | `-- ports.conf |
| 22 | # |-- mods-enabled |
| 23 | # | |-- *.load |
| 24 | # | `-- *.conf |
| 25 | # |-- conf-enabled |
| 26 | # | `-- *.conf |
| 27 | # `-- sites-enabled |
| 28 | # `-- *.conf |
| 29 | # |
| 30 | # |
| 31 | # * apache2.conf is the main configuration file (this file). It puts the pieces |
| 32 | # together by including all remaining configuration files when starting up the |
| 33 | # web server. |
| 34 | # |
| 35 | # * ports.conf is always included from the main configuration file. It is |
| 36 | # supposed to determine listening ports for incoming connections which can be |
| 37 | # customized anytime. |
| 38 | # |
| 39 | # * Configuration files in the mods-enabled/, conf-enabled/ and sites-enabled/ |
| 40 | # directories contain particular configuration snippets which manage modules, |
| 41 | # global configuration fragments, or virtual host configurations, |
| 42 | # respectively. |
| 43 | # |
| 44 | # They are activated by symlinking available configuration files from their |
| 45 | # respective *-available/ counterparts. These should be managed by using our |
| 46 | # helpers a2enmod/a2dismod, a2ensite/a2dissite and a2enconf/a2disconf. See |
| 47 | # their respective man pages for detailed information. |
| 48 | # |
| 49 | # * The binary is called apache2. Due to the use of environment variables, in |
| 50 | # the default configuration, apache2 needs to be started/stopped with |
| 51 | # /etc/init.d/apache2 or apache2ctl. Calling /usr/bin/apache2 directly will not |
| 52 | # work with the default configuration. |
| 53 | |
| 54 | |
| 55 | # Global configuration |
| 56 | # |
| 57 | |
| 58 | # |
| 59 | # ServerRoot: The top of the directory tree under which the server's |
| 60 | # configuration, error, and log files are kept. |
| 61 | # |
| 62 | # NOTE! If you intend to place this on an NFS (or otherwise network) |
| 63 | # mounted filesystem then please read the Mutex documentation (available |
| 64 | # at <URL:http://httpd.apache.org/docs/2.4/mod/core.html#mutex>); |
| 65 | # you will save yourself a lot of trouble. |
| 66 | # |
| 67 | # Do NOT add a slash at the end of the directory path. |
| 68 | # |
| 69 | #ServerRoot "/etc/apache2" |
| 70 | |
| 71 | # |
| 72 | # The accept serialization lock file MUST BE STORED ON A LOCAL DISK. |
| 73 | # |
| 74 | Mutex file:${APACHE_LOCK_DIR} default |
| 75 | |
| 76 | # |
| 77 | # PidFile: The file in which the server should record its process |
| 78 | # identification number when it starts. |
| 79 | # This needs to be set in /etc/apache2/envvars |
| 80 | # |
| 81 | PidFile ${APACHE_PID_FILE} |
| 82 | |
| 83 | # |
| 84 | # Timeout: The number of seconds before receives and sends time out. |
| 85 | # |
| 86 | Timeout 300 |
| 87 | |
| 88 | # |
| 89 | # KeepAlive: Whether or not to allow persistent connections (more than |
| 90 | # one request per connection). Set to "Off" to deactivate. |
| 91 | # |
| 92 | KeepAlive On |
| 93 | |
| 94 | # |
| 95 | # MaxKeepAliveRequests: The maximum number of requests to allow |
| 96 | # during a persistent connection. Set to 0 to allow an unlimited amount. |
| 97 | # We recommend you leave this number high, for maximum performance. |
| 98 | # |
| 99 | MaxKeepAliveRequests 100 |
| 100 | |
| 101 | # |
| 102 | # KeepAliveTimeout: Number of seconds to wait for the next request from the |
| 103 | # same client on the same connection. |
| 104 | # |
| 105 | KeepAliveTimeout 5 |
| 106 | |
| 107 | |
| 108 | # These need to be set in /etc/apache2/envvars |
| 109 | User ${APACHE_RUN_USER} |
| 110 | Group ${APACHE_RUN_GROUP} |
| 111 | |
| 112 | # |
| 113 | # HostnameLookups: Log the names of clients or just their IP addresses |
| 114 | # e.g., www.apache.org (on) or 204.62.129.132 (off). |
| 115 | # The default is off because it'd be overall better for the net if people |
| 116 | # had to knowingly turn this feature on, since enabling it means that |
| 117 | # each client request will result in AT LEAST one lookup request to the |
| 118 | # nameserver. |
| 119 | # |
| 120 | HostnameLookups Off |
| 121 | |
| 122 | # ErrorLog: The location of the error log file. |
| 123 | # If you do not specify an ErrorLog directive within a <VirtualHost> |
| 124 | # container, error messages relating to that virtual host will be |
| 125 | # logged here. If you *do* define an error logfile for a <VirtualHost> |
| 126 | # container, that host's errors will be logged there and not here. |
| 127 | # |
| 128 | ErrorLog ${APACHE_LOG_DIR}/error.log |
| 129 | |
| 130 | # |
| 131 | # LogLevel: Control the severity of messages logged to the error_log. |
| 132 | # Available values: trace8, ..., trace1, debug, info, notice, warn, |
| 133 | # error, crit, alert, emerg. |
| 134 | # It is also possible to configure the log level for particular modules, e.g. |
| 135 | # "LogLevel info ssl:warn" |
| 136 | # |
| 137 | LogLevel warn |
| 138 | |
| 139 | # Include module configuration: |
| 140 | IncludeOptional mods-enabled/*.load |
| 141 | IncludeOptional mods-enabled/*.conf |
| 142 | |
| 143 | # Include list of ports to listen on |
| 144 | Include ports.conf |
| 145 | |
| 146 | |
| 147 | # Sets the default security model of the Apache2 HTTPD server. It does |
| 148 | # not allow access to the root filesystem outside of /usr/share and /var/www. |
| 149 | # The former is used by web applications packaged in Debian, |
| 150 | # the latter may be used for local directories served by the web server. If |
| 151 | # your system is serving content from a sub-directory in /srv you must allow |
| 152 | # access here, or in any related virtual host. |
| 153 | <Directory /> |
| 154 | Options FollowSymLinks |
| 155 | AllowOverride None |
| 156 | Require all denied |
| 157 | </Directory> |
| 158 | |
| 159 | <Directory /usr/share> |
| 160 | AllowOverride None |
| 161 | Require all granted |
| 162 | </Directory> |
| 163 | |
| 164 | <Directory /var/www/> |
| 165 | Options Indexes FollowSymLinks |
| 166 | AllowOverride None |
| 167 | Require all granted |
| 168 | </Directory> |
| 169 | |
| 170 | #<Directory /srv/> |
| 171 | # Options Indexes FollowSymLinks |
| 172 | # AllowOverride None |
| 173 | # Require all granted |
| 174 | #</Directory> |
| 175 | |
| 176 | |
| 177 | |
| 178 | |
| 179 | # AccessFileName: The name of the file to look for in each directory |
| 180 | # for additional configuration directives. See also the AllowOverride |
| 181 | # directive. |
| 182 | # |
| 183 | AccessFileName .htaccess |
| 184 | |
| 185 | # |
| 186 | # The following lines prevent .htaccess and .htpasswd files from being |
| 187 | # viewed by Web clients. |
| 188 | # |
| 189 | <FilesMatch "^\.ht"> |
| 190 | Require all denied |
| 191 | </FilesMatch> |
| 192 | |
| 193 | |
| 194 | # |
| 195 | # The following directives define some format nicknames for use with |
| 196 | # a CustomLog directive. |
| 197 | # |
| 198 | # These deviate from the Common Log Format definitions in that they use %O |
| 199 | # (the actual bytes sent including headers) instead of %b (the size of the |
| 200 | # requested file), because the latter makes it impossible to detect partial |
| 201 | # requests. |
| 202 | # |
| 203 | # Note that the use of %{X-Forwarded-For}i instead of %h is not recommended. |
| 204 | # Use mod_remoteip instead. |
| 205 | # |
| 206 | LogFormat "%v:%p %h %l %u %t \"%r\" %>s %O \"%{Referer}i\" \"%{User-Agent}i\"" vhost_combined |
| 207 | LogFormat "%h %l %u %t \"%r\" %>s %O \"%{Referer}i\" \"%{User-Agent}i\"" combined |
| 208 | LogFormat "%h %l %u %t \"%r\" %>s %O" common |
| 209 | LogFormat "%{Referer}i -> %U" referer |
| 210 | LogFormat "%{User-agent}i" agent |
| 211 | |
| 212 | # Include of directories ignores editors' and dpkg's backup files, |
| 213 | # see README.Debian for details. |
| 214 | |
| 215 | # Include generic snippets of statements |
| 216 | IncludeOptional conf-enabled/*.conf |
| 217 | |
| 218 | # Include the virtual host configurations: |
| 219 | IncludeOptional sites-enabled/*.conf |
| 220 | |
| 221 | # vim: syntax=apache ts=4 sw=4 sts=4 sr noet |
| 222 | ServerName localhost |