lighttpd.conf

   1 # lighttpd configuration file
   2 #
   3 # use a it as base for lighttpd 1.0.0 and above
   4 #
   5 # $Id$
   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
  15 server.modules = (
  16 #       "mod_rewrite",
  17 #       "mod_redirect",
  18         "mod_access",
  19 #       "mod_auth",
  20 #       "mod_status",
  21 #       "mod_fastcgi",
  22 #       "mod_simple_vhost",
  23 #       "mod_evhost",
  24 #       "mod_cgi",
  25 #       "mod_compress",
  26 #       "mod_userdir",
  27 #       "mod_alias",
  28 #       "mod_ssi",
  29 #       "mod_usertrack",
  30 #       "mod_rrdtool",
  31 #       "mod_expire",
  32 #       "mod_localizer",
  33 #       "mod_proxy",
  34 #       "mod_secdownload",
  35         "mod_accesslog",
  36 )
  37
  38 ## a static document-root, for virtual-hosting take look at the
  39 ## server.virtual-* options
  40 server.document-root = "/home/services/lighttpd/html/"
  41
  42 ## where to send error-messages to
  43 server.errorlog = "/var/log/lighttpd/lighttpd.log"
  44
  45 # files to check for if .../ is requested
  46 server.indexfiles = (
  47         "index.php",
  48         "index.html",
  49         "index.htm",
  50         "default.htm",
  51 )
  52
  53 # mimetype mapping
  54 mimetype.assign = (
  55         ".pdf"          =>      "application/pdf",
  56         ".sig"          =>      "application/pgp-signature",
  57         ".spl"          =>      "application/futuresplash",
  58         ".class"        =>      "application/octet-stream",
  59         ".ps"           =>      "application/postscript",
  60         ".torrent"      =>      "application/x-bittorrent",
  61         ".dvi"          =>      "application/x-dvi",
  62         ".gz"           =>      "application/x-gzip",
  63         ".pac"          =>      "application/x-ns-proxy-autoconfig",
  64         ".swf"          =>      "application/x-shockwave-flash",
  65         ".tar.gz"       =>      "application/x-tgz",
  66         ".tgz"          =>      "application/x-tgz",
  67         ".tar"          =>      "application/x-tar",
  68         ".zip"          =>      "application/zip",
  69         ".mp3"          =>      "audio/mpeg",
  70         ".m3u"          =>      "audio/x-mpegurl",
  71         ".wma"          =>      "audio/x-ms-wma",
  72         ".wax"          =>      "audio/x-ms-wax",
  73         ".ogg"          =>      "audio/x-wav",
  74         ".wav"          =>      "audio/x-wav",
  75         ".gif"          =>      "image/gif",
  76         ".jpg"          =>      "image/jpeg",
  77         ".jpeg"         =>      "image/jpeg",
  78         ".png"          =>      "image/png",
  79         ".xbm"          =>      "image/x-xbitmap",
  80         ".xpm"          =>      "image/x-xpixmap",
  81         ".xwd"          =>      "image/x-xwindowdump",
  82         ".css"          =>      "text/css",
  83         ".html"         =>      "text/html",
  84         ".htm"          =>      "text/html",
  85         ".js"           =>      "text/javascript",
  86         ".asc"          =>      "text/plain",
  87         ".c"            =>      "text/plain",
  88         ".conf"         =>      "text/plain",
  89         ".text"         =>      "text/plain",
  90         ".txt"          =>      "text/plain",
  91         ".dtd"          =>      "text/xml",
  92         ".xml"          =>      "text/xml",
  93         ".mpeg"         =>      "video/mpeg",
  94         ".mpg"          =>      "video/mpeg",
  95         ".mov"          =>      "video/quicktime",
  96         ".qt"           =>      "video/quicktime",
  97         ".avi"          =>      "video/x-msvideo",
  98         ".asf"          =>      "video/x-ms-asf",
  99         ".asx"          =>      "video/x-ms-asf",
 100         ".wmv"          =>      "video/x-ms-wmv"
 101 )
 102
 103 # Use the "Content-Type" extended attribute to obtain mime type if possible
 104 #mimetype.use-xattr = "enable"
 105
 106 #### accesslog module
 107 accesslog.filename = "/var/log/lighttpd/access.log"
 108
 109 ## deny access the file-extensions
 110 #
 111 # ~    is for backupfiles from vi, emacs, joe, ...
 112 # .inc is often used for code includes which should in general not be part
 113 #      of the document-root
 114 url.access-deny = ( "~", ".inc" )
 115
 116 ######### Options that are good to be but not neccesary to be changed #######
 117
 118 ## bind to port (default: 80)
 119 #server.port = 81
 120
 121 ## bind to localhost (default: all interfaces)
 122 #server.bind = "grisu.home.kneschke.de"
 123
 124 ## error-handler for status 404
 125 #server.error-handler-404 = "/error-handler.html"
 126 #server.error-handler-404 = "/error-handler.php"
 127
 128 ## to help the rc.scripts
 129 #server.pid-file = "/var/run/lighttpd.pid"
 130
 131 ###### virtual hosts
 132 ##
 133 ##   If you want name-based virtual hosting add the next three settings and load
 134 ##   mod_simple_vhost
 135 ##
 136 ## document-root =
 137 ##   virtual-server-root + virtual-server-default-host + virtual-server-docroot or
 138 ##   virtual-server-root + http-host + virtual-server-docroot
 139 ##
 140 #simple-vhost.server-root         = "/home/weigon/wwwroot/servers/"
 141 #simple-vhost.default-host        = "grisu.home.kneschke.de"
 142 #simple-vhost.document-root       = "/pages/"
 143
 144
 145 ##
 146 ## Format: <errorfile-prefix><status>.html
 147 ## -> ..../status-404.html for 'File not found'
 148 #server.errorfile-prefix = "/home/weigon/projects/lighttpd/doc/status-"
 149
 150 ## virtual directory listings
 151 #server.dir-listing          = "enable"
 152
 153 ## send unhandled HTTP-header headers to error-log
 154 #debug.dump-unknown-headers  = "enable"
 155
 156 ### only root can use these options
 157 #
 158 # chroot() to directory (default: no chroot() )
 159 #server.chroot            = "/"
 160
 161 ## change uid to <uid> (default: don't care)
 162 server.username            = "lighttpd"
 163
 164 ## change uid to <uid> (default: don't care)
 165 server.groupname           = "lighttpd"
 166
 167 #### compress module
 168 #compress.cache-dir          = "/tmp/lighttpd/cache/compress/"
 169 #compress.filetype           = ("text/plain", "text/html")
 170
 171 #### fastcgi module
 172 ## read fastcgi.txt for more info
 173 #fastcgi.server = (
 174 #       ".php" => (
 175 #               "localhost" => (
 176 #                       "socket" => "/var/run/php/php-fastcgi.sock",
 177 #                       "bin-path" => "/usr/bin/php.fcgi",
 178 #               )
 179 #       )
 180 #)
 181
 182
 183 #### CGI module
 184 #cgi.assign = (
 185 #       ".pl"  => "/usr/bin/perl",
 186 #       ".cgi" => "/usr/bin/perl",
 187 #)
 188
 189 #### SSL engine
 190 #ssl.engine = "enable"
 191 #ssl.pemfile = "server.pem"
 192
 193 #### status module
 194 #status.status-url = "/server-status"
 195 #status.config-url = "/server-config"
 196
 197 #### auth module
 198 ## read authentification.txt for more info
 199 ## debugging
 200 # 0 for off, 1 for 'auth-ok' messages, 2 for verbose debugging
 201 #auth.debug = 1
 202 ## type of backend
 203 # plain, htpasswd, ldap or htdigest
 204 #auth.backend = "plain"
 205 # filename of the password storage
 206 ## for plain
 207 #auth.backend.plain.userfile = "/etc/lighttpd/lighttpd.user"
 208 #auth.backend.plain.groupfile = "/etc/lighttpd/lighttpd.group"
 209 ## for htpasswd
 210 #auth.backend.htpasswd.userfile = "/etc/lighttpd/lighttpd-htpasswd.user"
 211 ## for htdigest
 212 #auth.backend.htdigest.userfile = "/etc/lighttpd/lighttpd-htdigest.user"
 213 ## for ldap
 214 # the $ in auth.backend.ldap.filter is replaced by the
 215 # 'username' from the login dialog
 216 #auth.backend.ldap.hostname = "localhost"
 217 #auth.backend.ldap.base-dn  = "dc=my-domain,dc=com"
 218 #auth.backend.ldap.filter   = "(uid=$)"
 219
 220 #auth.require = (
 221 #       "/server-status" => (
 222 #               "method"  => "digest",
 223 #               "realm"   => "download archiv",
 224 #               "require" => "user=agent007|user=agent008"
 225 #       ),
 226 #       "/server-info" => (
 227 #               "method"  => "digest",
 228 #               "realm"   => "download archiv",
 229 #               "require" => "group=www|user=jan|host=192.168.2.10"
 230 #       ),
 231 #       "/server-config" => (
 232 #               "method"  => "ldap",
 233 #               "realm"   => "server config",
 234 #               "require" => "user=glen"
 235 #       ),
 236 #)
 237
 238
 239 #### url handling modules (rewrite, redirect, access)
 240 #url.rewrite                 = ( "^/$"             => "/server-status" )
 241 #url.redirect                = ( "^/wishlist/(.+)" => "http://www.123.org/$1" )
 242
 243 # define a pattern for the host url finding
 244 # %% => % sign
 245 # %0 => domain name + tld
 246 # %1 => tld
 247 # %2 => domain name without tld
 248 # %3 => subdomain 1 name
 249 # %4 => subdomain 2 name
 250 #
 251 #evhost.path-pattern = "/home/storage/dev/www/%3/htdocs/"
 252
 253 #### expire module
 254 #expire.url = (
 255 #       "/buggy/" => "access 2 hours",
 256 #       "/asdhas/" => "access plus 1 seconds 2 minutes",
 257 #)
 258
 259 #### ssi
 260 #ssi.extension = ( ".shtml" )
 261
 262 #### rrdtool
 263 #rrdtool.binary = "/usr/bin/rrdtool"
 264 #rrdtool.db-name = "/var/www/lighttpd.rrd"
 265
 266 #### userdir module
 267 #userdir.path = "public_html"
 268 #userdir.exclude-user = ( "root", "postmaster" )
 269 #
 270 ## if set, only users from this list may use the feature
 271 #userdir.include-user = ""
 272
 273 #### alias module
 274 #alias.url = (
 275 #       "/cgi-bin/" => "/usr/lib/cgi-bin",
 276 #)
 277