2 APACHE INSTALLATION OVERVIEW
7 For complete installation documentation, see [ht]docs/manual/install.html or
8 http://httpd.apache.org/docs/2.5/install.html
10 $ ./configure --prefix=PREFIX
13 $ PREFIX/bin/apachectl start
15 NOTES: * Replace PREFIX with the filesystem path under which
16 Apache should be installed. A typical installation
17 might use "/usr/local/apache2" for PREFIX (without the
20 * Read the section "APR - Unix" below.
22 * If you are a developer building Apache directly from
23 Subversion, you will need to run ./buildconf before running
24 configure. This script bootstraps the build environment and
25 requires Python as well as GNU autoconf and libtool. If you
26 build Apache from a release tarball, you don't have to run
29 * If you want to build a threaded MPM (for instance worker)
30 on FreeBSD, be aware that threads do not work well with
31 Apache on FreeBSD versions before 5.4-RELEASE. If you wish
32 to try a threaded Apache on an earlier version of FreeBSD,
33 use the --enable-threads parameter to ./configure in
34 addition to the --with-mpm parameter.
36 * If you are building directly from Subversion on Mac OS X
37 (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
38 recent versions of the developer tools on this platform
39 include a sufficiently recent version of GNU Libtool (named
40 glibtool, but buildconf knows where to find it).
42 For a short impression of what possibilities you have, here is a
43 typical example which configures Apache for the installation tree
44 /sw/pkg/apache with a particular compiler and flags plus the two
45 additional modules mod_rewrite and mod_speling for later loading
46 through the DSO mechanism:
48 $ CC="pgcc" CFLAGS="-O2" \
49 ./configure --prefix=/sw/pkg/apache \
50 --enable-rewrite=shared \
51 --enable-speling=shared
53 The easiest way to find all of the configuration flags for Apache 2.5
54 is to run ./configure --help.
59 httpd trunk (httpd development version 2.5) can use APR trunk (future
60 APR version 2.0) or the combination of the current APR 1.x branch and
61 the current APR-util 1.x branch. (APR trunk bundles the features in
64 The httpd buildconf step, required when building httpd from Subversion,
65 must have access to the APR source. The httpd configure step, always
66 required, can configure the APR source in srclib or use a previously-
69 APR (and APR-util if using APR 1.x) can be built with httpd from httpd's
70 srclib directory or can be built separately, prior to building httpd.
72 Building APR with httpd from httpd's srclib directory is required if
73 you don't have the compiler which the system APR was built with, and it
74 can also be advantageous if you are a developer who will be linking your
75 code with httpd or using a debugger to step through server code, as it
76 removes the possibility of version or compile-option mismatches with
77 APR and APR-util code.
79 To use APR trunk in srclib:
81 Check out APR trunk in srclib/apr with the following command:
83 svn co http://svn.apache.org/repos/asf/apr/apr/trunk srclib/apr
85 buildconf will find it automaticaly. Use the --with-included-apr
86 argument to httpd configure.
88 To use APR 1.x and APR-util 1.x in srclib:
90 Check out the current branches as srclib/apr and srclib/apr-util with
91 the following commands:
93 svn co http://svn.apache.org/repos/asf/apr/apr/branches/1.4.x srclib/apr
94 svn co http://svn.apache.org/repos/asf/apr/apr-util/branches/1.5.x srclib/apr-util
96 buildconf will find them automaticaly. Use the --with-included-apr
97 argument to httpd configure.
99 To use existing checkouts of APR (and APR-util if using APR 1.x):
101 httpd buildconf must have access to the source trees. Use these arguments
104 --with-apr=[path to apr source] --with-apr-util=[path to apr-util source]
106 (Omit --with-apr-util if using APR trunk.)
108 httpd configure must have access to a previously build apr. Use these
109 arguments to httpd configure:
111 --with-apr=[path to apr install] --with-apr-util=[path to apr-util install]
113 (Omit --with-apr-util if using APR trunk.)
116 Quick Start - Windows
117 ---------------------
119 For complete documentation, see manual/platform/windows.html.en or
120 http://httpd.apache.org/docs/2.5/platform/windows.html.
122 The Apache/Win32 binaries are distributed as Windows Installer packages
123 (.msi) named httpd-2.5.xx-win32-x86-no_ssl.msi for a version without mod_ssl
124 and httpd-2.5.xx-win32-x86-openssl-1.0.1x.msi for a version including the
125 mod_ssl plus the openssl library and command line utility. Additional 64 bit
126 binaries have similarly named -win64-x64 package names. These packages
127 may be unpacked without "installing" them by using the msiexec /a option.
129 If you have unpacked a source distribution (named httpd-2.5.x-win32-src.zip,
130 without any -x86 or -x64 notation) you must compile the package yourself,
131 see the links mentioned above. Unless you intended to do this, please look
132 again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/
133 and install that desired .msi package.
135 The .msi package configures the httpd.conf file, and installs and starts
136 the Apache2.x service for you. It also installs plenty of useful shortcuts
137 and the taskbar ApacheMonitor. We strongly encourage you to use it.
143 The Apache HTTP Server group cannot field user's installation questions.
144 There are many valuable forums to help you get started. Please refer your
145 questions to the appropriate forum, such as the Users Mailing List at
146 http://httpd.apache.org/userslist.html or the usenet newsgroups
147 comp.infosystems.www.servers.unix or
148 comp.infosystems.www.servers.ms-windows.
150 Thanks for using the Apache HTTP Server, version 2.5.
152 The Apache Software Foundation
153 http://www.apache.org/