Docs ConfigurationOptions » History » Revision 53
Revision 52 (icy, 2008-10-12 13:12) → Revision 53/175 (nitrox, 2008-10-12 13:44)
h1. Configuration File Options Here you will find a list of all available configuration options for lighttpd. They are grouped by module, and a link to each module configuration will provide with more detail information about each option, as well as examples, and other guidelines. h2. Lighttpd Core Options |_. option |_. description |_. details | | connection.kbytes-per-second | limit the throughput for each single connection to the given limit in kbyte/s | [[lighttpd:Docs:TrafficShaping|Details]] | | etag.use-inode | Determines if inode-value is used in ETag generation | [[etag.use-inodeDetails|Details]] | | etag.use-mtime | Determines if mtime-value is used in ETag generation | [[etag.use-mtimeDetails|Details]] | | etag.use-size | Determines if size-value is used in ETag generation | [[etag.use-sizeDetails|Details]] | | index-file.names | list of files to search for if a directory is requested | [[index-file-names.Details|Details]] | | mimetype.assign | list of known mimetype mappings | [[mimetype.assignDetails|Details]] | | mimetype.use-xattr | try to use XFS-style extended attribute interface for retreiving the Content-Type | [[mimetype.use-xattrDetails|Details]] | | server.bind | IP address, hostname or absolute path to the unix-domain socket | [[server.bindDetails|Details]] | | server.chroot | root-directory of the server | [[server.chrootDetails|Details]] | | server.core-files | enable core files | | | server.dir-listing | enable/disable dir listing | [[lighttpd:Docs:ModDirlisting|Details]] | | server.document-root | document-root of the webserver | [[server.document-rootDetails|Details]] | | server.event-handler | set the event handler | [[server.event-handlerDetails|Details]] | | server.errorlog | pathname of the error-log | [[server.errorlogDetails|Details]] | | server.errorlog-use-syslog* | send errorlog to syslog | [[server.errorlog-use-syslogDetails|Details]] | | server.error-handler-404 | uri to call if the requested file results in a 404 | [[server.error-handler-404Details|Details]] | | server.errorfile-prefix | path prefix for special status codes pages | [[server.errorfile-prefixDetails|Details]] | | server.follow-symlink | allow to follow-symlinks | [[server.follow-symlinksDetails|Details]] | | server.force-lowercase-filenames | enable force all filenames to lowercase | | | server.groupname | groupname used to run the server | [[server.groupnameDetails|Details]] | | server.kbytes-per-second | limit the throughput for all connections to the given limit in kbyte/s | [[lighttpd:Docs:TrafficShaping|Details]] | | server.max-connections | maximum connections | [[server.max-connectionsDetails|Details]] | | server.max-fds | maximum number of file descriptors | [[server.max-fdsDetails|Details]] | | server.max-keep-alive-idle | maximum number of seconds until a idling keep-alive connection is droped | [[server.max-keep-alive-idleDetails|Details]] | | server.max-keep-alive-requests | maximum number of request within a keep-alive session | [[server.max-keep-alive-requestsDetails|Details]] | | server.max-read-idle | maximum number of seconds until a waiting, non keep-alive read times out and closes the connection | [[server.max-read-idleDetails|Details]] | | server.max-request-size | maximum size in kbytes of the request | [[server.max-request-sizeDetails|Details]] | | server.max-worker | number of worker processes to spawn | [[server.max-workerDetails|Details]] | | server.max-write-idle | maximum number of seconds until a waiting write call times out | [[server.max-write-idleDetails|Details]] | | server.modules | modules to load | [[server.modulesDetails|Details]] | | server.name | name of the server/virtual server | [[server.nameDetails|Details]] | | server.network-backend | basic network interface for all platforms at the syscalls read() and write() | [[server.network-backendDetails|Details]] | | server.pid-file | set the name and location of the .pid-file | [[server.pid-fileDetails|Details]] | | server.protocol-http11 | defines if HTTP/1.1 is allowed or not | [[server.protocol-http11Details|Details]] | | server.range-requests | defines if range requests are allowed or not | [[server.range-requestsDetails|Details]] | | server.stat-cache-engine | select stat() call caching | [[server.stat-cache-engineDetails|Details]] | | server.tag | set the string returned by the server | [[server.use-tagDetails|Details]] | | server.username | username used to run the server | [[server.usernameDetails|Details]] | | server.upload-dirs | path to upload directory | [[server.upload-dirsDetails|Details]] | | server.use-ipv6 | bind to the IPv6 socket | | | static-file.etags | Determines if ETags are generated or not | | | static-file.exclude-extensions | forbid access to the source of some types of files by extension | | h3. SSL Options |_. option |_. description |_. details | | ssl.engine | *ssl.engine*: enable/disable ssl engine | | | ssl.pemfile | engine. *ssl.pemfile*: path to the PEM file for SSL support | support. [[lighttpd:Docs:SSL|Details]] | | ssl.ca-file | *ssl.ca-file*: path to the CA file for support of chained certificates | certificates. [[lighttpd:Docs:SSL|Details]] | h3. Core Debug Info |_. option |_. description | | debug.log-request-header | *debug.log-request-header*: log all request headers | | debug.log-file-not-found | headers. *debug.log-file-not-found*: log if a file wasn't found | | debug.log-condition-handling | found. *debug.log-condition-handling*: log conditionals handling for debugging | | debug.log-request-header-on-error | debugging. *debug.log-request-header-on-error*: log request header, but only when there is an error | | debug.log-request-handling | error. *debug.log-request-handling*: log request handling inside lighttpd | | debug.log-state-handling | lighttpd. *debug.log-state-handling*: log state handling inside lighttpd | | debug.log-response-header | lighttpd. *debug.log-response-header*: log the header we send out to the client | | debug.log-ssl-noise | client. *debug.log-ssl-noise*: log some ssl warnings we hide by default (ssl handshake, unknown/bad certificate) | * certificate). [[DebugVariables|Debug Variable Information]] h2. Options for mod_access - access restrictions module |_. option |_. description | | url.access-deny | *url.access-deny*: Denies access to all files with any of given trailing path names | * names. [[lighttpd:Docs:ModAccess|mod_access documentation]] h2. Options for mod_accesslog - access log files module |_. option |_. description | | accesslog.use-syslog | *accesslog.use-syslog*: send the accesslog to syslog | | accesslog.format | syslog. *accesslog.format*: the format of the logfile | | accesslog.filename | logfile. *accesslog.filename*: name of the file where the accesslog should be written to if syslog is not used | * used. [[lighttpd:Docs:ModAccessLog|mod_accesslog documentation]] h2. Options for mod_alias - directory aliases module |_. option |_. description | | alias.url | *alias.url*: rewrites the document-root for a URL-subset | * URL-subset. [[lighttpd:Docs:ModAlias|mod_alias documentation]] h2. Options for mod_auth - authentication module |_. option |_. description | | auth.debug | *auth.debug*: enable/disable authentication module debug information | | auth.backend | information. *auth.backend*: type of authentication backend | | auth.require | | | auth.backend.ldap.hostname | backend. *auth.require*: *auth.backend.ldap.hostname*: hostname of ldap server | | auth.backend.ldap.starttls | | | auth.backend.ldap.filter | | | auth.backend.ldap.bind-pw | | | auth.backend.ldap.ca-file | | | auth.backend.ldap.base-dn | | | auth.backend.ldap.bind-dn | | | auth.backend.plain.userfile | server. *auth.backend.ldap.starttls*: *auth.backend.ldap.filter*: *auth.backend.ldap.bind-pw*: *auth.backend.ldap.ca-file*: *auth.backend.ldap.base-dn*: *auth.backend.ldap.bind-dn*: *auth.backend.plain.userfile*: path to plain userfile | | auth.backend.plain.groupfile | userfile. *auth.backend.plain.groupfile*: path to plain groupfile | | auth.backend.htdigest.userfile | groupfile. *auth.backend.htdigest.userfile*: path to htdigest userfile | | auth.backend.htpasswd.userfile | userfile. *auth.backend.htpasswd.userfile*: path to htpassword userfile | * userfile. [[lighttpd:Docs:ModAuth|mod_auth documentation]] h2. Options for mod_cache - web accelerating module *cache.bases*: directory arrays which want to save cache files *cache.enable*: *cache.domains*: domain pcre regex arrays which mod_cache will cache *cache.support-queries*: *cache.debug*: writes mod_cache debuging messages to error.log or not *cache.purge-host*: pcre regex hosts ip which are allowed to PURGE cache file *cache.refresh-pattern*: [[lighttpd:Docs:ModCache|mod_cache documentation]] h2. Options for mod_cgi - cgi module *cgi.assign*: assign cgi handler to an extension. [[lighttpd:Docs:ModCGI|mod_cgi documentation]] h2. Options for mod_cml - Cache Meta Language module *cml.memcache-namespace*: (not used yet) *cml.power-magnet*: a cml file that is executed for each request. *cml.memcache-hosts*: hosts for the memcache.* functions. *cml.extension*: the file extension that is bound to the cml-module. [[lighttpd:Docs:ModCML|mod_cml documentation]] h2. Options for mod_compress - compress output module *compress.max-filesize*: maximum size of the original file to be compressed kBytes. *compress.cache-dir*: name of the directory where compressed content will be cached. *compress.filetype*: mimetypes which might get compressed. [[lighttpd:Docs:ModCompress|mod_compress documentation]] h2. Options for mod_deflate - dynamic compression module (Patch) *deflate.enabled*: enable/disable deflate support. *deflate.compression-level*: level of compression. *deflate.mem-level*: *deflate.window-size*: *deflate.bzip2*: enable/disable bzip support. *deflate.min-compress-size*: minimum size document before compressing. *deflate.sync-flush*: enable sync flush. *deflate.output-buffer-size*: size of buffer for compression. *deflate.work-block-size*: minimum block size for compression. *deflate.mimetypes*: mimetype listing to be compressed. *deflate.debug*: enable debug. [[Mod_Deflate|mod_deflate documentation]] h2. Options for mod_dirlisting - directory listing module *server.dir-listing*: enable/disable directory listing. *dir-listing.activate*: enables virtual directory listings if a directory is requested no index-file was found. *dir-listing.external-css*: path to an external css stylesheet for the directory listing. *dir-listing.encoding*: set a encoding for the generated directory listing. *dir-listing.hide-dotfiles*: if enabled, does not list hidden files in directory listings generated by the dir-listing option. *dir-listing.show-header*: include HEADER.txt files above the directory listing.. *dir-listing.hide-header-file*: enables hide header file from directory listing. *dir-listing.show-readme*: include README.txt files above the directory listing. *dir-listing.hide-readme-file*: enables displaying readme file in directory listing. *dir-listing.exclude*: files that match any of the specified regular expressions will be excluded from listings. *dir-listing.set-footer*: displays a string in the footer of a listing page. [[lighttpd:Docs:ModDirlisting|mod_dirlisting documentation]] h2. Options for mod_evasive - evasive module (version 1.5.0) *evasive.max-conns-per-ip*: upper limit of number of connections per ip allowed. h2. Options for mod_evhost - enhanced virtual host module *evhost.path-pattern*: pattern with wildcards to be replace to build a documentroot. [[lighttpd:Docs:ModEVhost|mod_evhost documentation]] h2. Options for mod_expire - cached expiration module *expire.url*: assignes a expiration to all files below the specified path. [[lighttpd:Docs:ModExpire|mod_expire documentation]] h2. Options for mod_extforward - extract the client's "real" IP from X-Forwarded-For header *extforward.forwarder*: set trust level of proxy ip's [[DocsModExtForward|mod_extforward documentation]] h2. Options for mod_fastcgi - fastcgi module *fastcgi.map-extensions*: map multiple extensions to the same fastcgi server. *fastcgi.debug*: a value between 0 and 65535 to set the debug-level in the FastCGI module. *fastcgi.server*: tell the module where to send FastCGI requests to. host: is hostname/ip of the FastCGI process. port: is tcp-port on the "host" used by the FastCGI process. socket: path to the unix-domain socket. bin-path: path to the local FastCGI binary which should be started if no local FastCGI is running. bin-environment: set environment of FastCGI binary. bin-copy-environment: copy environment from server for FastCGI binary. mode: is the FastCGI protocol mode. Default is "responder", also "authorizer" mode is implemented. docroot: docroot on the remote host. allow-x-send-file: controls if X-LIGHTTPD-send-file and X-Sendfile headers are allowed. broken-scriptfilename: breaks SCRIPT_FILENAME in a way that PHP can extract PATH_INFO from it. idle-timeout: number of seconds before a unused process gets terminated. max-procs: upper limit of processes to start. min-procs: sets the minimum processes to start. min-procs-not-working: max-load-per-proc: maximum number of waiting processes on average per process before a new process is spawned. check-local: enable/disable check for requested file in document root. disable-time: time to wait before a disabled backend is checked again. strip-request-uri: strip part of request-uri. [[lighttpd:Docs:ModFastCGI|mod_fastcgi documentation]] h2. Options for mod_flv_streaming - flv streaming module *flv-streaming.extensions*: extensions of flv files "Blog Entry":http://blog.lighttpd.net/articles/2006/03/09/flv-streaming-with-lighttpd "Additional Information ":http://jan.kneschke.de/projects/flv-streaming/ "Flash Video Player 3.5 (Creative Commons)":http://www.jeroenwijering.com/embed/streaming.html h2. Options for mod_mem_cache - local file accelerating *mem-cache.filetypes*: content-type arrays which want to put into memory *mem-cache.enable*: *mem-cache.max-memory*: maxium memory in Mbytes mod-mem-cache can use *mem-cache.max-file-size*: maxium file size in Kbytes of single file to cache in memory *mem-cache.lru-remove-count*: *mem-cache.expire-time*: memory cache's expire time in minutes *mem-cache.slru-thresold* : slru threshold (against hit counter) [[lighttpd:Docs:ModMemCache|mod_mem_cache documentation]] h2. Options for mod_mysql_vhost - Mysql virtual hosting module *mysql-vhost.hostname*: hostname of mysql server. *mysql-vhost.db*: database name. *mysql-vhost.user*: username to access database. *mysql-vhost.pass*: password to access database. *mysql-vhost.sql*: SQL statement to execute to obtain docroot. *mysql-vhost.port*: port where to connect to database. *mysql-vhost.sock*: socket where to connect to database. [[lighttpd:Docs:ModMySQLVhost|mod_mysql_vhost documentation]] h2. Options for mod_proxy - proxy module *proxy.server*: where to send Proxy requests. host: ip of host to send requests. port: listening port of host. *proxy.balance*: select type of balancing algorithm (round-robin, hash, fair). *proxy.debug*: enable/disable proxy debug information. [[lighttpd:Docs:ModProxy|mod_proxy documentation]] h2. Options for mod_redirect - redirect module *url.redirect*: redirects a set of URLs externally. [[lighttpd:Docs:ModRedirect|mod_redirect documentation]] h2. Options for mod_rewrite - rewriting module *url.rewrite-once*: rewrites a set of URLs internally and skip the rest. *url.rewrite-repeat*: rewrites a set of URLs internally in the webserver, continue applying rewrite rules. *url.rewrite*: same as url.rewrite-once. *url.rewrite-final*: same as url.rewrite-once. [[lighttpd:Docs:ModRewrite|mod_rewrite documentation]] h2. Options for mod_rrdtool - rrdtool module *rrdtool.db-name*: filename of the rrd-database. *rrdtool.binary*: path to the rrdtool binary. [[lighttpd:Docs:ModRRDTool|mod_rrdtool documentation]] h2. Options for mod_scgi - SCGI Module *scgi.map-extensions*: map multiple extensions to the same scgi server. *scgi.debug*: a value between 0 and 65535 to set the debug-level in the SCGI module. *scgi.server*: tell the module where to send SCGI requests to. host: is hostname/ip of the SCGI process. port: is tcp-port on the "host" used by the SCGI process. socket: path to the unix-domain socket. bin-path: path to the local SCGI binary which should be started if no local SCGI is running. bin-environment: set environment of SCGI binary. bin-copy-environment: copy environment from server for SCGI binary. docroot: docroot on the remote host. allow-x-send-file: controls if X-LIGHTTPD-send-file and X-Sendfile headers are allowed. broken-scriptfilename: breaks SCRIPT_FILENAME in a way that PHP can extract PATH_INFO from it. idle-timeout: number of seconds before a unused process gets terminated. max-procs: upper limit of processes to start. min-procs: sets the minium processes to start. min-procs-not-working: max-load-per-proc: maximum number of waiting processes on average per process before a new process is spawned. check-local: enable/disable check for requested file in document root. disable-time: time to wait before a disabled backend is checked again. strip-request-uri: strip part of request-uri. [[lighttpd:Docs:ModSCGI|mod_scgi documentation]] h2. Options for mod_secure_download - secure and fast download module *secdownload.document-root*: path to the download area. *secdownload.timeout*: how long in seconds is the secret valid. *secdownload.uri-prefix*: prefix to url for download. *secdownload.secret *: Secret string that will be used for the checksum calculation. [[lighttpd:Docs:ModSecDownload|mod_secure_download documentation]] h2. Options for mod_setenv - set HTTP Environment module *setenv.add-response-header*: adds a value to the process environment that is passed to the external applications. *setenv.add-request-header*: adds a header to the HTTP response sent to the client. *setenv.add-environment*: adds a value to the process environment that is passed to the external applications. [[lighttpd:Docs:ModSetEnv|mod_setenv documentation]] h2. Options for mod_simple_vhost - simple virtual host module *simple-vhost.document-root*: path below the vhost directory. *simple-vhost.server-root*: root of the virtual host. *simple-vhost.default-host*: use this hostname if the requested hostname does not have its own directory. *simple-vhost.debug*: debug simple vhosts module. [[lighttpd:Docs:ModSimpleVhost|mod_simple_vhost documentation]] h2. Options for mod_ssi - server side includes module *ssi.extension*: extension of files processed by mod_ssi. [[lighttpd:Docs:ModSSI|mod_ssi documentation]] h2. Options for mod_status - server status module *status.config-url*: relative URL for the config page which displays the loaded modules. *status.statistics-url*: relative URL for a plain-text page containing the internal statistics. *status.enable-sort*: add JavaScript which allows client-side sorting for the connection overview. *status.status-url*: relative URL which is used to retrieve the status-page. [[lighttpd:Docs:ModStatus|mod_status documentation]] h2. Options for mod_trigger_b4_dl - trigger before download module *trigger-before-download.trigger-url*: url for trigger pages. *trigger-before-download.trigger-timeout*: time for download link to live. *trigger-before-download.download-url*: url for downloads. *trigger-before-download.deny-url*: url to show when visitor denied a download. *trigger-before-download.gdbm-filename*: path to gdm file. *trigger-before-download.memcache-hosts*: hosts for the memcache.* functions. *trigger-before-download.memcache-namespace*: (not used yet) *trigger-before-download.debug*: [[lighttpd:Docs:ModTriggerBeforeDownload|mod_trigger_b4_dl documentation]] h2. Options for mod_userdir - user directories *userdir.basepath*: if set, don't check /etc/passwd for homedir. *userdir.exclude-user*: list of usernames which may not use this feature. *userdir.path*: usually it should be set to "public_html" to take ~/public_html/ as the document root. *userdir.include-user*: if set, only users from this list may use the feature. [[lighttpd:Docs:ModUserDir|mod_userdir documentation]] h2. Options for mod_uploadprogress - upload progress module (version 1.5.0) *upload-progress.progress-url*: h2. Options for mod_usertrack - user track module (cookies) *usertrack.cookie-name*: ~~'_usertrack.cookiename_'~~: (deprecated) *usertrack.cookie-domain*: *usertrack.cookie-max-age*: [[lighttpd:Docs:ModUserTrack|mod_usertrack documentation]] h2. Options for mod_webdav - WebDAV module *webdav.activate*: enable/disable WebDAV. *webdav.is-readonly*: enable/disable read only. *webdav.sqlite-db-name*: pathname to SQLite database. *webdav.log-xml*: Log the XML Request bodies for debugging. [[lighttpd:Docs:ModWebDAV|mod_webdav documentation]]