| 1 | # lighttpd configuration file |
|---|
| 2 | # |
|---|
| 3 | # use it as a base for lighttpd 1.0.0 and above |
|---|
| 4 | # |
|---|
| 5 | # $Id: lighttpd.conf,v 1.7 2004/11/03 22:26:05 weigon Exp $ |
|---|
| 6 | |
|---|
| 7 | ############ Options you really have to take care of #################### |
|---|
| 8 | |
|---|
| 9 | ## modules to load |
|---|
| 10 | # at least mod_access and mod_accesslog should be loaded |
|---|
| 11 | # all other module should only be loaded if really neccesary |
|---|
| 12 | # - saves some time |
|---|
| 13 | # - saves memory |
|---|
| 14 | server.modules = ( |
|---|
| 15 | "mod_rewrite", |
|---|
| 16 | # "mod_redirect", |
|---|
| 17 | # "mod_alias", |
|---|
| 18 | "mod_access", |
|---|
| 19 | # "mod_cml", |
|---|
| 20 | # "mod_trigger_b4_dl", |
|---|
| 21 | # "mod_auth", |
|---|
| 22 | # "mod_status", |
|---|
| 23 | # "mod_setenv", |
|---|
| 24 | "mod_fastcgi", |
|---|
| 25 | # "mod_proxy", |
|---|
| 26 | # "mod_simple_vhost", |
|---|
| 27 | # "mod_evhost", |
|---|
| 28 | # "mod_userdir", |
|---|
| 29 | # "mod_cgi", |
|---|
| 30 | # "mod_compress", |
|---|
| 31 | # "mod_ssi", |
|---|
| 32 | # "mod_usertrack", |
|---|
| 33 | # "mod_expire", |
|---|
| 34 | # "mod_secdownload", |
|---|
| 35 | # "mod_rrdtool", |
|---|
| 36 | "mod_accesslog" ) |
|---|
| 37 | |
|---|
| 38 | ## a static document-root, for virtual-hosting take look at the |
|---|
| 39 | ## server.virtual-* options |
|---|
| 40 | server.document-root = "/Users/username/Desktop" |
|---|
| 41 | |
|---|
| 42 | ## where to send error-messages to |
|---|
| 43 | server.errorlog = "/var/log/lighttpd.error.log" |
|---|
| 44 | |
|---|
| 45 | # files to check for if .../ is requested |
|---|
| 46 | index-file.names = ( "index.php", "index.html", |
|---|
| 47 | "index.htm", "default.htm" ) |
|---|
| 48 | |
|---|
| 49 | ## set the event-handler (read the performance section in the manual) |
|---|
| 50 | # server.event-handler = "freebsd-kqueue" # needed on OS X |
|---|
| 51 | |
|---|
| 52 | # mimetype mapping |
|---|
| 53 | mimetype.assign = ( |
|---|
| 54 | ".pdf" => "application/pdf", |
|---|
| 55 | ".sig" => "application/pgp-signature", |
|---|
| 56 | ".spl" => "application/futuresplash", |
|---|
| 57 | ".class" => "application/octet-stream", |
|---|
| 58 | ".ps" => "application/postscript", |
|---|
| 59 | ".torrent" => "application/x-bittorrent", |
|---|
| 60 | ".dvi" => "application/x-dvi", |
|---|
| 61 | ".gz" => "application/x-gzip", |
|---|
| 62 | ".pac" => "application/x-ns-proxy-autoconfig", |
|---|
| 63 | ".swf" => "application/x-shockwave-flash", |
|---|
| 64 | ".tar.gz" => "application/x-tgz", |
|---|
| 65 | ".tgz" => "application/x-tgz", |
|---|
| 66 | ".tar" => "application/x-tar", |
|---|
| 67 | ".zip" => "application/zip", |
|---|
| 68 | ".mp3" => "audio/mpeg", |
|---|
| 69 | ".m3u" => "audio/x-mpegurl", |
|---|
| 70 | ".wma" => "audio/x-ms-wma", |
|---|
| 71 | ".wax" => "audio/x-ms-wax", |
|---|
| 72 | ".ogg" => "application/ogg", |
|---|
| 73 | ".wav" => "audio/x-wav", |
|---|
| 74 | ".gif" => "image/gif", |
|---|
| 75 | ".jpg" => "image/jpeg", |
|---|
| 76 | ".jpeg" => "image/jpeg", |
|---|
| 77 | ".png" => "image/png", |
|---|
| 78 | ".xbm" => "image/x-xbitmap", |
|---|
| 79 | ".xpm" => "image/x-xpixmap", |
|---|
| 80 | ".xwd" => "image/x-xwindowdump", |
|---|
| 81 | ".css" => "text/css", |
|---|
| 82 | ".html" => "text/html", |
|---|
| 83 | ".htm" => "text/html", |
|---|
| 84 | ".js" => "text/javascript", |
|---|
| 85 | ".asc" => "text/plain", |
|---|
| 86 | ".c" => "text/plain", |
|---|
| 87 | ".cpp" => "text/plain", |
|---|
| 88 | ".log" => "text/plain", |
|---|
| 89 | ".conf" => "text/plain", |
|---|
| 90 | ".text" => "text/plain", |
|---|
| 91 | ".txt" => "text/plain", |
|---|
| 92 | ".dtd" => "text/xml", |
|---|
| 93 | ".xml" => "text/xml", |
|---|
| 94 | ".mpeg" => "video/mpeg", |
|---|
| 95 | ".mpg" => "video/mpeg", |
|---|
| 96 | ".mov" => "video/quicktime", |
|---|
| 97 | ".qt" => "video/quicktime", |
|---|
| 98 | ".avi" => "video/x-msvideo", |
|---|
| 99 | ".asf" => "video/x-ms-asf", |
|---|
| 100 | ".asx" => "video/x-ms-asf", |
|---|
| 101 | ".wmv" => "video/x-ms-wmv", |
|---|
| 102 | ".bz2" => "application/x-bzip", |
|---|
| 103 | ".tbz" => "application/x-bzip-compressed-tar", |
|---|
| 104 | ".tar.bz2" => "application/x-bzip-compressed-tar" |
|---|
| 105 | ) |
|---|
| 106 | |
|---|
| 107 | # Use the "Content-Type" extended attribute to obtain mime type if possible |
|---|
| 108 | #mimetype.use-xattr = "enable" |
|---|
| 109 | |
|---|
| 110 | |
|---|
| 111 | ## send a different Server: header |
|---|
| 112 | ## be nice and keep it at lighttpd |
|---|
| 113 | # server.tag = "lighttpd" |
|---|
| 114 | |
|---|
| 115 | #### accesslog module |
|---|
| 116 | accesslog.filename = "/var/log/lighttpd.access.log" |
|---|
| 117 | |
|---|
| 118 | ## deny access the file-extensions |
|---|
| 119 | # |
|---|
| 120 | # ~ is for backupfiles from vi, emacs, joe, ... |
|---|
| 121 | # .inc is often used for code includes which should in general not be part |
|---|
| 122 | # of the document-root |
|---|
| 123 | url.access-deny = ( "~", ".inc" ) |
|---|
| 124 | |
|---|
| 125 | $HTTP["url"] =~ "\.pdf$" { |
|---|
| 126 | server.range-requests = "disable" |
|---|
| 127 | } |
|---|
| 128 | |
|---|
| 129 | ## |
|---|
| 130 | # which extensions should not be handle via static-file transfer |
|---|
| 131 | # |
|---|
| 132 | # .php, .pl, .fcgi are most often handled by mod_fastcgi or mod_cgi |
|---|
| 133 | static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" ) |
|---|
| 134 | |
|---|
| 135 | ######### Options that are good to be but not neccesary to be changed ####### |
|---|
| 136 | |
|---|
| 137 | ## bind to port (default: 80) |
|---|
| 138 | server.port = 8080 |
|---|
| 139 | |
|---|
| 140 | ## bind to localhost (default: all interfaces) |
|---|
| 141 | #server.bind = "grisu.home.kneschke.de" |
|---|
| 142 | |
|---|
| 143 | ## error-handler for status 404 |
|---|
| 144 | #server.error-handler-404 = "/error-handler.html" |
|---|
| 145 | #server.error-handler-404 = "/error-handler.php" |
|---|
| 146 | |
|---|
| 147 | ## to help the rc.scripts |
|---|
| 148 | #server.pid-file = "/var/run/lighttpd.pid" |
|---|
| 149 | |
|---|
| 150 | |
|---|
| 151 | ###### virtual hosts |
|---|
| 152 | ## |
|---|
| 153 | ## If you want name-based virtual hosting add the next three settings and load |
|---|
| 154 | ## mod_simple_vhost |
|---|
| 155 | ## |
|---|
| 156 | ## document-root = |
|---|
| 157 | ## virtual-server-root + virtual-server-default-host + virtual-server-docroot |
|---|
| 158 | ## or |
|---|
| 159 | ## virtual-server-root + http-host + virtual-server-docroot |
|---|
| 160 | ## |
|---|
| 161 | #simple-vhost.server-root = "/home/weigon/wwwroot/servers/" |
|---|
| 162 | #simple-vhost.default-host = "grisu.home.kneschke.de" |
|---|
| 163 | #simple-vhost.document-root = "/pages/" |
|---|
| 164 | |
|---|
| 165 | |
|---|
| 166 | ## |
|---|
| 167 | ## Format: <errorfile-prefix><status-code>.html |
|---|
| 168 | ## -> ..../status-404.html for 'File not found' |
|---|
| 169 | #server.errorfile-prefix = "/home/weigon/projects/lighttpd/doc/status-" |
|---|
| 170 | |
|---|
| 171 | ## virtual directory listings |
|---|
| 172 | #dir-listing.activate = "enable" |
|---|
| 173 | |
|---|
| 174 | ## enable debugging |
|---|
| 175 | #debug.log-request-header = "enable" |
|---|
| 176 | #debug.log-response-header = "enable" |
|---|
| 177 | #debug.log-request-handling = "enable" |
|---|
| 178 | #debug.log-file-not-found = "enable" |
|---|
| 179 | |
|---|
| 180 | ### only root can use these options |
|---|
| 181 | # |
|---|
| 182 | # chroot() to directory (default: no chroot() ) |
|---|
| 183 | #server.chroot = "/" |
|---|
| 184 | |
|---|
| 185 | ## change uid to <uid> (default: don't care) |
|---|
| 186 | #server.username = "wwwrun" |
|---|
| 187 | |
|---|
| 188 | ## change uid to <uid> (default: don't care) |
|---|
| 189 | #server.groupname = "wwwrun" |
|---|
| 190 | |
|---|
| 191 | #### compress module |
|---|
| 192 | #compress.cache-dir = "/tmp/lighttpd/cache/compress/" |
|---|
| 193 | #compress.filetype = ("text/plain", "text/html") |
|---|
| 194 | |
|---|
| 195 | #### proxy module |
|---|
| 196 | ## read proxy.txt for more info |
|---|
| 197 | #proxy.server = ( ".php" => |
|---|
| 198 | # ( "localhost" => |
|---|
| 199 | # ( |
|---|
| 200 | # "host" => "192.168.0.101", |
|---|
| 201 | # "port" => 80 |
|---|
| 202 | # ) |
|---|
| 203 | # ) |
|---|
| 204 | # ) |
|---|
| 205 | |
|---|
| 206 | #### fastcgi module |
|---|
| 207 | ## read fastcgi.txt for more info |
|---|
| 208 | ## for PHP don't forget to set cgi.fix_pathinfo = 1 in the php.ini |
|---|
| 209 | fastcgi.server = ( "/code.py" => |
|---|
| 210 | ( "localhost" => |
|---|
| 211 | ( |
|---|
| 212 | "socket" => "/tmp/fastcgi.socket", |
|---|
| 213 | "bin-path" => "/Users/username/Desktop/code.py", |
|---|
| 214 | "max-procs" => 1 |
|---|
| 215 | ) |
|---|
| 216 | ) |
|---|
| 217 | ) |
|---|
| 218 | |
|---|
| 219 | #### CGI module |
|---|
| 220 | #cgi.assign = ( ".pl" => "/usr/bin/perl", |
|---|
| 221 | # ".cgi" => "/usr/bin/perl" ) |
|---|
| 222 | # |
|---|
| 223 | |
|---|
| 224 | #### SSL engine |
|---|
| 225 | #ssl.engine = "enable" |
|---|
| 226 | #ssl.pemfile = "server.pem" |
|---|
| 227 | |
|---|
| 228 | #### status module |
|---|
| 229 | #status.status-url = "/server-status" |
|---|
| 230 | #status.config-url = "/server-config" |
|---|
| 231 | |
|---|
| 232 | #### auth module |
|---|
| 233 | ## read authentication.txt for more info |
|---|
| 234 | #auth.backend = "plain" |
|---|
| 235 | #auth.backend.plain.userfile = "lighttpd.user" |
|---|
| 236 | #auth.backend.plain.groupfile = "lighttpd.group" |
|---|
| 237 | |
|---|
| 238 | #auth.backend.ldap.hostname = "localhost" |
|---|
| 239 | #auth.backend.ldap.base-dn = "dc=my-domain,dc=com" |
|---|
| 240 | #auth.backend.ldap.filter = "(uid=$)" |
|---|
| 241 | |
|---|
| 242 | #auth.require = ( "/server-status" => |
|---|
| 243 | # ( |
|---|
| 244 | # "method" => "digest", |
|---|
| 245 | # "realm" => "download archiv", |
|---|
| 246 | # "require" => "user=jan" |
|---|
| 247 | # ), |
|---|
| 248 | # "/server-config" => |
|---|
| 249 | # ( |
|---|
| 250 | # "method" => "digest", |
|---|
| 251 | # "realm" => "download archiv", |
|---|
| 252 | # "require" => "valid-user" |
|---|
| 253 | # ) |
|---|
| 254 | # ) |
|---|
| 255 | |
|---|
| 256 | #### url handling modules (rewrite, redirect, access) |
|---|
| 257 | url.rewrite-once = ( |
|---|
| 258 | "^/favicon.ico$" => "/static/favicon.ico", |
|---|
| 259 | "^/static/(.*)$" => "/static/$1", |
|---|
| 260 | "^/(.*)$" => "/code.py/$1", |
|---|
| 261 | ) |
|---|
| 262 | #url.rewrite = ( "^/$" => "/server-status" ) |
|---|
| 263 | #url.redirect = ( "^/wishlist/(.+)" => "http://www.123.org/$1" ) |
|---|
| 264 | #### both rewrite/redirect support back reference to regex conditional using %n |
|---|
| 265 | #$HTTP["host"] =~ "^www\.(.*)" { |
|---|
| 266 | # url.redirect = ( "^/(.*)" => "http://%1/$1" ) |
|---|
| 267 | #} |
|---|
| 268 | |
|---|
| 269 | # |
|---|
| 270 | # define a pattern for the host url finding |
|---|
| 271 | # %% => % sign |
|---|
| 272 | # %0 => domain name + tld |
|---|
| 273 | # %1 => tld |
|---|
| 274 | # %2 => domain name without tld |
|---|
| 275 | # %3 => subdomain 1 name |
|---|
| 276 | # %4 => subdomain 2 name |
|---|
| 277 | # |
|---|
| 278 | #evhost.path-pattern = "/home/storage/dev/www/%3/htdocs/" |
|---|
| 279 | |
|---|
| 280 | #### expire module |
|---|
| 281 | #expire.url = ( "/buggy/" => "access 2 hours", "/asdhas/" => "access plus 1 seconds 2 minutes") |
|---|
| 282 | |
|---|
| 283 | #### ssi |
|---|
| 284 | #ssi.extension = ( ".shtml" ) |
|---|
| 285 | |
|---|
| 286 | #### rrdtool |
|---|
| 287 | #rrdtool.binary = "/usr/bin/rrdtool" |
|---|
| 288 | #rrdtool.db-name = "/var/www/lighttpd.rrd" |
|---|
| 289 | |
|---|
| 290 | #### setenv |
|---|
| 291 | #setenv.add-request-header = ( "TRAV_ENV" => "mysql://user@host/db" ) |
|---|
| 292 | #setenv.add-response-header = ( "X-Secret-Message" => "42" ) |
|---|
| 293 | |
|---|
| 294 | ## for mod_trigger_b4_dl |
|---|
| 295 | # trigger-before-download.gdbm-filename = "/home/weigon/testbase/trigger.db" |
|---|
| 296 | # trigger-before-download.memcache-hosts = ( "127.0.0.1:11211" ) |
|---|
| 297 | # trigger-before-download.trigger-url = "^/trigger/" |
|---|
| 298 | # trigger-before-download.download-url = "^/download/" |
|---|
| 299 | # trigger-before-download.deny-url = "http://127.0.0.1/index.html" |
|---|
| 300 | # trigger-before-download.trigger-timeout = 10 |
|---|
| 301 | |
|---|
| 302 | ## for mod_cml |
|---|
| 303 | ## don't forget to add index.cml to server.indexfiles |
|---|
| 304 | # cml.extension = ".cml" |
|---|
| 305 | # cml.memcache-hosts = ( "127.0.0.1:11211" ) |
|---|
| 306 | |
|---|
| 307 | #### variable usage: |
|---|
| 308 | ## variable name without "." is auto prefixed by "var." and becomes "var.bar" |
|---|
| 309 | #bar = 1 |
|---|
| 310 | #var.mystring = "foo" |
|---|
| 311 | |
|---|
| 312 | ## integer add |
|---|
| 313 | #bar += 1 |
|---|
| 314 | ## string concat, with integer cast as string, result: "www.foo1.com" |
|---|
| 315 | #server.name = "www." + mystring + var.bar + ".com" |
|---|
| 316 | ## array merge |
|---|
| 317 | #index-file.names = (foo + ".php") + index-file.names |
|---|
| 318 | #index-file.names += (foo + ".php") |
|---|
| 319 | |
|---|
| 320 | #### include |
|---|
| 321 | #include /etc/lighttpd/lighttpd-inc.conf |
|---|
| 322 | ## same as above if you run: "lighttpd -f /etc/lighttpd/lighttpd.conf" |
|---|
| 323 | #include "lighttpd-inc.conf" |
|---|
| 324 | |
|---|
| 325 | #### include_shell |
|---|
| 326 | #include_shell "echo var.a=1" |
|---|
| 327 | ## the above is same as: |
|---|
| 328 | #var.a=1 |
|---|
