--enable-layout=LAYOUT

Configure the source code and build scripts to assume an installation tree based on the layout LAYOUT. This allows you to separately specify the locations for each type of file within the Apache HTTP Server installation. The config.layout file contains several example configurations, and you can also create your own custom configuration following the examples. The different layouts in this file are grouped into <Layout FOO>...</Layout> sections and referred to by name as in FOO. The default layout is Apache.

For better control of the installation directories, use the options below. Please note that the directory defaults are set by autoconf and be overwritten by the corresponding layout setting.

--bindir=DIR

Install user executables in DIR. The user executables are supporting programs like htpasswd, dbmmanage, etc. which are useful for site administrators. By default DIR is set to EPREFIX/bin.

--datadir=DIR

Install read-only architecture-independent data in DIR. By default datadir is set to PREFIX/share. This option is offered by autoconf and currently unused.

--includedir=DIR

Install C header files in DIR. By default includedir is set to EPREFIX/include.

--infodir=DIR

Install info documentation in DIR. By default infodir is set to PREFIX/info. This option is currently unused.

--libdir=DIR

Install object code libraries in DIR. By default libdir is set to EPREFIX/lib.

--libexecdir=DIR

Install the program executables (i.e., shared modules) in DIR. By default libexecdir is set to EPREFIX/libexec.

--localstatedir=DIR

Install modifiable single-machine data in DIR. By default localstatedir is set to PREFIX/var. This option is offered by autoconf and currently unused.

--mandir=DIR

Install the man documentation in DIR. By default mandir is set to EPREFIX/man.

--oldincludedir=DIR

Install C header files for non-gcc in DIR. By default oldincludedir is set to /usr/include. This option is offered by autoconf and currently unused.

--sbindir=DIR

Install the system administrator executables in DIR. Those are server programs like httpd, apachectl, suexec, etc. which are neccessary to run the Apache HTTP Server. By default sbindir is set to EPREFIX/sbin.

--sharedstatedir=DIR

Install modifiable architecture-independent data in DIR. By default sharedstatedir is set to PREFIX/com. This option is offered by autoconf and currently unused.

--sysconfdir=DIR

Install read-only single-machine data like the server configuration files httpd.conf, mime.types, etc. in DIR. By default sysconfdir is set to PREFIX/conf.

Generally you can use the following syntax to enable or disable a feature:

--disable-FEATURE

Do not include FEATURE. This is the same as --enable-FEATURE=no.

--enable-FEATURE[=ARG]

Include FEATURE. The default value for ARG is yes.

--enable-MODULE=shared

The corresponding module will be build as DSO module.

--enable-MODULE=static

By default enabled modules are linked statically. You can force this explicitly.

Some modules are compiled by default and have to be disabled explicitly. Use the following options to remove discrete modules from the compilation process.

--disable-actions

Disable action triggering on requests, which is provided by mod_actions.

--disable-alias

Disable the mapping of requests to different parts of the filesystem, which is provided by mod_alias.

--disable-asis

Disable support for as-is filetypes, which is provided by mod_asis.

--disable-auth

Disable user-based access control provided by mod_auth. This module provides for HTTP Basic Authentication, where the usernames and passwords are stored in plain text files.

--disable-autoindex

Disable the directory listing functionality provided by mod_autoindex.

--disable-access

Disable host-based access control provided by mod_access.

--disable-cgi

mod_cgi, which provides support for CGI scripts, is enabled by default when using a non-threaded MPM. Use this option to disable CGI support.

--disable-cgid

When using the threaded MPMs worker or perchild support for CGI scripts is provided by mod_cgid by default. To disable CGI support use this option.

--disable-charset-lite

Disable character set translation provided by mod_charset_lite. This module will be installed by default only on EBCDIC systems.

--disable-dir

Disable directory request handling provided by mod_dir.

--disable-env

Disable setting and clearing of environment variables, which is provided by mod_env.

--disable-http

Disable the HTTP protocol handling. The http module is a basic one, enabling the server to function as an HTTP server. It is only useful to disable it if you want to use another protocol module instead. Don't disable this module unless you are really sure what you are doing.
Note: This module will always be linked statically.

--disable-imap

Disable support for server based imagemaps, which provided by mod_imap.

--disable-include

Disable Server Side Includes provided by mod_include.

--disable-log-config

Disable the logging configuration provided by mod_log_config. You won't be able to log requests to the server without this module.

--disable-mime

mod_mime associates the requested filename's extensions with the file's behavior and content (mime-type, language, character set and encoding). Disabling the mapping of file-extensions to MIME is normally not recommended.

--disable-negotiation

Disable content negotiation provided by mod_negotiation.

--disable-setenvif

Disable support for basing environment variables on headers, which is provided by mod_setenvif.

--disable-status

Disable the process/thread monitoring, which is provided by mod_status.

--disable-userdir

Disable the mapping of requests to user-specific directories, which is provided by mod_userdir.

Some modules are compiled by default and have to be enabled explicitly or by using the keywords most or all (see --enable-mods-shared below for further explanation) to be available. Therefore use the options below.

--enable-auth-anon

Enable anonymous user access provided by mod_auth_anon.

--enable-auth-dbm

mod_auth_dbm provides for HTTP Basic Authentication, where the usernames and passwords are stored in DBM type database files. Use this option to enable the module.

--enable-auth-digest

Enable RFC2617 Digest authentication provided by mod_auth_digest. This module uses plain text files to store the credentials.

--enable-auth-ldap

Enable LDAP based authentication provided by mod_auth_ldap.

--enable-cache

Enable dynamic file caching provided by mod_cache. This experimental module may be interesting for servers with high load or caching proxy servers. At least one storage management module (e.g. mod_disk_cache or mod_mem_cache) is also necessary.

--enable-cern-meta

Enable the CERN-type meta files support provided by mod_cern_meta.

--enable-charset-lite

Enable character set translation provided by mod_charset_lite. This module will be installed by default only on EBCDIC systems. On other systems, you have to enable it.

--enable-dav

Enable the WebDAV protocol handling provided by mod_dav. Support for filesystem resources is provided by the seperate module mod_dav_fs. This module is also automatically enabled with --enable-dav.
Note: mod_dav can only be used together with the http protocol module.

--enable-dav-fs

Enable DAV support for filesystem resources, which is provided by mod_dav_fs. This module is a provider for the mod_dav module, so you should also use --enable-dav.

--enable-deflate

Enable deflate transfer encoding provided by mod_deflate.

--enable-disk-cache

Enable disk caching provided by mod_disk_cache.

--enable-expires

Enable Expires header control provided by mod_expires.

--enable-ext-filter

Enable the external filter support provided by mod_ext_filter.

--enable-file-cache

Enable the file cache provided by mod_file_cache.

--enable-headers

Enable control of HTTP headers provided by mod_headers.

--enable-info

Enable the server information provided by mod_info.

--enable-ldap

Enable LDAP caching and connection pooling services provided by mod_ldap.

--enable-logio

Enable logging of input and output bytes including headers provided by mod_logio.

--enable-mem-cache

Enable memory caching provided by mod_mem_cache.

--enable-mime-magic

Enable automatical determining of MIME types, which is provided by mod_mime_magic.

--enable-isapi

Enable the isapi extension support provided by mod_isapi.

--enable-proxy

Enable the proxy/gateway functionality provided by mod_proxy. The proxying capabilities for CONNECT, FTP and HTTP are provided by the seperate modules mod_proxy_connect, mod_proxy_ftp and mod_proxy_http. These three modules are also automatically enabled with --enable-proxy.

--enable-proxy-connect

Enable proxy support for CONNECT request handling, which is provided by mod_proxy_connect. This module is an extension for the mod_proxy module, so you should also use --enable-proxy.

--enable-proxy-ftp

Enable proxy support for FTP requests, which is provided by mod_proxy_ftp.. This module is an extension for the mod_proxy module, so you should also use --enable-proxy.

--enable-proxy-http

Enable proxy support for HTTP requests, which is provided by mod_proxy_http. This module is an extension for the mod_proxy module, so you should also use --enable-proxy.

--enable-rewrite

Enable rule based URL manipulation provided by mod_rewrite.

--enable-so

Enable DSO capability provided by mod_so. This module will be automatically enabled if you use the --enable-mods-shared option.

--enable-speling

Enable the functionality to correct common URL misspellings, which is provided by mod_speling.

--enable-ssl

Enable support for SSL/TLS provided by mod_ssl.

--enable-unique-id

Enable the generation of per-request unique ids, which is provided by mod_unique_id.

--enable-usertrack

Enable user-session tracking provided by mod_usertrack.

--enable-vhost-alias

Enable mass virtual hosting provided by mod_vhost_alias.

The following modules are useful only for developers and testing purposes and are disabled by default. Use the following options to enable them. If you are not sure whether you need one of these modules, omit them.

--enable-bucketeer

Enable the manipulation filter for buckets, which is provided by mod_bucketeer.

--enable-case-filter

Enable the example uppercase conversion output filter support of mod_case_filter.

--enable-case-filter-in

Enable the example uppercase conversion input filter support of mod_case_filter_in.

--enable-echo

Enable the ECHO server provided by mod_echo.

--enable-example

Enable the example and demo module mod_example.

--enable-optional-fn-export

Enable the example for an optional function exporter, which is provided by mod_optional_fn_export.

--enable-optional-fn-import

Enable the example for an optional function importer, which is provided by mod_optional_fn_import.

--enable-optional-hook-export

Enable the example for an optional hook exporter, which is provided by mod_optional_hook_export.

--enable-optional-hook-import

Enable the example optional hook importer, which is provided by mod_optional_hook_import.

To add the necessary Multi Processing Module and additional third-party modules use the following options:

--with-module=module-type:module-file[, module-type:module-file]

Add one or more third-party modules to the list of statically linked modules. The module source file module-file will be searched in the modules/module-type subdirectory of your Apache HTTP server source tree. If it is not found there configure is considering module-file to be an absolute file path and tries to copy the source file into the module-type subdirectory. If the subdirectory doesn't exist it will be created and populated with a standard Makefile.in.

This option is useful to add small external modules consisting of one source file. For more complex modules you should read the vendor's documentation.

If you want to build a DSO module instead of a statically linked use apxs.

--with-mpm=MPM

Choose the process model for your server. You have to select exactly one Multi-Processing Module. Otherwise the default MPM for your operating system will be taken. Possible MPMs are beos, leader, mpmt_os2, perchild, prefork, threadpool and worker.

--enable-maintainer-mode

Turn on debugging and compile time warnings.

--enable-mods-shared=MODULE-LIST

Defines a list of modules to be enabled and build as dynamic shared modules. This mean, these module have to be loaded dynamically by using the LoadModule directive.

MODULE-LIST is a space separated list of modulenames enclosed by quotation marks. The module names are given without the preceding mod_. For example:

--enable-mods-shared='headers rewrite dav'

Additionally you can use the special keywords all and most. For example,

--enable-mods-shared=most

will compile most modules and build them as DSO modules.

--enable-modules=MODULE-LIST

This option behaves similar to --enable-mods-shared, but will link the given modules statically. This mean, these modules will always be present while running httpd. They need not be loaded with LoadModule.

--enable-v4-mapped

Allow IPv6 sockets to handle IPv4 connections.

--with-port=PORT

This defines the port on which httpd will listen. This port number is used when generating the configuration file httpd.conf. The default is 80.

--with-program-name

Define an alternative executable name. The default is httpd.

Generally you can use the following syntax to define an optional package:

--with-PACKAGE[=ARG]

Use the package PACKAGE. The default value for ARG is yes.

--without-PACKAGE

Do not use the package PACKAGE. This is the same as --with-PACKAGE=no. This option is provided by autoconf but not very useful for the Apache HTTP Server.

--with-apr=DIR|FILE

The Apache Portable Runtime (APR) is part of the httpd source distribution and will automatically be build together with the HTTP server. If you want to use an already installed APR instead you have to tell configure the path to the apr-config script. You may set the absolute path and name or the directory to the installed APR. apr-config must exist within this directory or the subdirectory bin.

--with-apr-util=DIR|FILE

The Apache Portable Runtime Utilities (APU) are part of the httpd source distribution and will automatically be build together with the HTTP server. If you want to use an already installed APU instead you have to tell configure the path to the apu-config script. You may set the absolute path and name or the directory to the installed APU. apu-config must exist within this directory or the subdirectory bin.

--with-ssl=DIR

If mod_ssl has been enabled configure searches for an installed OpenSSL. You can set the directory path to the SSL/TLS toolkit instead.

--with-z=DIR

configure searches automatically for an installed zlib library if your source configuration requires one (e.g., when mod_deflate is enabled). You can set the directory path to the compression library instead.

Several features of the Apache HTTP Server, including mod_authn_dbm and mod_rewrite's DBM RewriteMap use simple key/value databases for quick lookups of information. SDBM is included in the APU, so this database is always available. If you would like to use other database types, use the following options to enable them:

--with-gdbm[=path]

If no path is specified, configure will search for the include files and libraries of a GNU DBM installation in the usual search paths. An explicit path will cause configure to look in path/lib and path/include for the relevant files. Finally, the path may specify specific include and library paths separated by a colon.

--with-ndbm[=path]

Like --with-gdbm, bur searches for a New DBM installation.

--with-berkeley-db[=path]

Like --with-gdbm, but searches for a Berkeley DB installation.

The following options are used to fine tune the behavior of suexec. See Configuring and installing suEXEC or further information.

--with-suexec-bin

This defines the path to suexec binary. Default is --sbindir (see Fine tuning of installation directories).

--with-suexec-caller

This defines the user allowed to call suexec. It should be the same as the user under which httpd normally runs.

--with-suexec-docroot

This defines the directory tree under which suexec access is allowed for executables. Default value is --datadir/htdocs.

--with-suexec-gidmin

Define this as the lowest GID allowed to be a target user for suexec. The default value is 100.

--with-suexec-logfile

This defines the filename of the suexec logfile. By default the logfile is named suexec_log and located in --logfiledir.

--with-suexec-safepath

Define the value of the environment variable PATH to be set for processes started by suexec. Default value is /usr/local/bin:/usr/bin:/bin.

--with-suexec-userdir

This defines the subdirectory under the user's directory that contains all executables for which suexec access is allowed. This setting is necessary when you want to use suexec together with user-specific directories (as provided by mod_userdir). The default is public_html.

--with-suexec-uidmin

Define this as the lowest UID allowed to be a target user for suexec. The default value is 100.

--with-suexec-umask

Set umask for processes started by suexec. It defaults to your system settings.