configure - Configure the source tree

Available Languages: en

+ +

The configure script configures the source tree + for compiling and installing the Apache HTTP Server at your + particular platform. Various options allow the compilation of a + server corresponding to your personal requirements.

+ +

This script, included in the root directory of the distribution, + is for compilation on Unix and Unix-like systems only. For other + platforms, see the platform + documentation.

Synopsis
Options
Environment variables

Synopsis

You should call the configure script from within the + root directory of the distribution.

+ +

./configure [OPTION]... + [VAR=VALUE]...

+ +

To assign environment variables (e.g., CC, + CFLAGS ...), specify them as + VAR=VALUE. See below + for descriptions of some of the useful variables.

+ +

Configuration options

+ +

The following options influence the behavior of + configure itself.

+ +

-C
--config-cache: This is an alias for --cache-file=config.cache
--cache-file=FILE: The test results will be cached in file FILE. + This option is disabled by default.
-h
--help [short|recursive]: Output the help and exit. With the argument short only + options specific to this package will displayed. The argument + recursive displays the short help of all the included + packages.
-n
--no-create: The configure script is running normally but does + not create output files. This is useful to check the test results + before generating makefiles for compilation.
-q
--quiet: Do not print checking ... messages during the + configure process.
--srcdir=DIR: Defines directory DIR to be the source file directory. + Default is the directory, where configure is located, or the parent + directory ...
--silent: Same as --quiet
-V
--version: Display copyright information and exit.

+ + +

Installation + directories

+ +

These options define the installation directory. The installation + tree depends on the selected layout.

+ +

--prefix=PREFIX: Install architecture-independent files in PREFIX. + By default the installation directory is set to + /usr/local/apache2.
--exec-prefix=EPREFIX: Install architecture-dependent files in EPREFIX. + By default the installation directory is set to the + PREFIX directory.

+ +

By default, make install will install all the files in + /usr/local/apache2/bin, /usr/local/apache2/lib + etc. You can specify an installation prefix other than + /usr/local/apache2 using --prefix, + for instance --prefix=$HOME.

+ +

Define a directory layout

--enable-layout=LAYOUT: Configure the source code and build scripts to assume an + installation tree based on the layout LAYOUT. The default + layout is Apache.

+ + +

Fine tuning of the installation + directories

+ +

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/etc.

+ + + +

System types

+ +

These options are used to crosscompile the Apache HTTP Server to run on + another system. In normal cases, when building and running the server on + the same system, these options are not used.

+ +

--build=BUILD: Defines the system type of the system on which the tools are being + built. It defaults to the result of the script + config.guess.
--host=HOST: Defines the system type of the system on which the server will run. + HOST defaults to BUILD.
--target=TARGET: Configure for building compilers for the system type + TARGET. It defaults to HOST. This option is + offered by autoconf and not necessary for the Apache HTTP + Server.

+ + +

Optional Features

+ +

These options are used to fine tune the features your HTTP server will + have.

+ +

General syntax

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.

+ + +

Enable or disable discrete modules

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

+ +

--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.

--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

Enable 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 until 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.

--disable-mime

Disable the mapping of file-extensions to MIME, which is provided by + mod_mime.

--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

Enable 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.

--enable-auth-anon

Enable anonymous user access provided by + mod_auth_anon.

--enable-auth-dbm

Enable support for DBM-based access databases provided by + mod_auth_dbm.

--enable-auth-digest

Enable RFC2617 Digest authentication provided by + mod_auth_digest.

--enable-auth-ldap

Enable LDAP based authentication provided by + mod_auth_ldap.

--enable-bucketeer

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

--enable-cache

Enable dynamic file caching provided by + mod_cache.

--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-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 provides 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-echo

Enable the ECHO server provided by + mod_echo.

--enable-example

Enable the example and demo module + mod_example.

--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-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.

--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 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_spelling.

--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.

--with-module=module-type:module-file +

Add a third-party module 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 so it has to be + placed there before. If it is not found here + configure is considering module-file to be a + an absolute file path and tries to copy the source file into the + module-type subdirectory.

This option is useful to add small external modules consiting of + one source file. For bigger modules you should read the vendors + documentation.

Note

+ 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.

+ + +

Cumulative and other options

--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.

--enable-vhost-alias

Enable mass virtual hosting provided by + mod_vhost_alias.

--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 alternate executable name.

+ + + +

Optional packages

These options are used to define optional packages.

+ +

General syntax

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

+ +

--with-PACKAGE[=ARG]: Use the package PACKAGE. The default value for + ARG isyes.
--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.

+ + + + +

Specific packages

--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 + exists 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 + exists 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.

+ + + +

Options for support programs

--enable-static-support: Build a statically linked version of the support binaries. This + means, a stand-alone executable will be build with all necessary + libraries are integrated. Otherwise the support binaries are linked + dynamically by default.
--enable-suexec: Use this option to enable suexec, which allows you to set uid + and gid for spawned processes. Further options to configure + suexec are described below.

+ +

It is possible to create a statically linked binary of a single + support program by using the following options:

+ +

--enable-static-ab: Build a statically linked version of ab.
--enable-static-checkgid: Build a statically linked version of checkgid.
--enable-static-htdbm: Build a statically linked version of htdbm.
--enable-static-htdigest: Build a statically linked version of htdigest.
--enable-static-htpasswd: Build a statically linked version of htpasswd.
--enable-static-logresolve: Build a statically linked version of logresolve.
--enable-static-rotatelogs: Build a statically linked version of rotatelogs.

+ +

suexec configuration options

The following options are used to fine tune the behavior of suexec. See Configuring and installing suEXEC + for 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 default to your system settings.

+ + +

Environment variables

There are some useful environment variables to override the choices made by + configure or to help it to find libraries and programs with + nonstandard names or locations.

+ + +

CC: Define the C compiler command to be used for compilation.
CFLAGS: Set C compiler flags you want to use for compilation.
CPP: Define the C preprocessor command to be used.
CPPFLAGS: Set C/C++ preprocessor flags, e.g. -Iincludedir + if you have headers in a nonstandard directory includedir.
LDFLAGS: Set linker flags, e.g. -Llibdir if you have + libraries in a nonstandard directory libdir.

configure - Configure the source tree

See also

Note