2 APACHE INSTALLATION OVERVIEW
7 For complete installation documentation, see [ht]docs/manual/install.html or
8 http://httpd.apache.org/docs/2.4/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 * Consider if you want to use a previously installed APR and
21 APR-Util (such as those provided with many OSes) or if you
22 need to use the APR and APR-Util from the apr.apache.org
23 project. If the latter, download the latest versions and
24 unpack them to ./srclib/apr and ./srclib/apr-util (no
25 version numbers in the directory names) and use
26 ./configure's --with-included-apr option. This is required
27 if you don't have the compiler which the system APR was
28 built with. It can also be advantageous if you are a
29 developer who will be linking your code with Apache or using
30 a debugger to step through server code, as it removes the
31 possibility of version or compile-option mismatches with APR
34 * If you are a developer building Apache directly from
35 Subversion, you will need to run ./buildconf before running
36 configure. This script bootstraps the build environment and
37 requires Python as well as GNU autoconf and libtool. If you
38 build Apache from a release tarball, you don't have to run
41 * If you want to build a threaded MPM (for instance worker)
42 on FreeBSD, be aware that threads do not work well with
43 Apache on FreeBSD versions before 5.4-RELEASE. If you wish
44 to try a threaded Apache on an earlier version of FreeBSD,
45 use the --enable-threads parameter to ./configure in
46 addition to the --with-mpm parameter.
48 * If you are building directly from Subversion on Mac OS X
49 (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
50 recent versions of the developer tools on this platform
51 include a sufficiently recent version of GNU Libtool (named
52 glibtool, but buildconf knows where to find it).
54 For a short impression of what possibilities you have, here is a
55 typical example which configures Apache for the installation tree
56 /sw/pkg/apache with a particular compiler and flags plus the two
57 additional modules mod_rewrite and mod_speling for later loading
58 through the DSO mechanism:
60 $ CC="pgcc" CFLAGS="-O2" \
61 ./configure --prefix=/sw/pkg/apache \
62 --enable-rewrite=shared \
63 --enable-speling=shared
65 The easiest way to find all of the configuration flags for Apache 2.4
66 is to run ./configure --help.
72 For complete documentation, see manual/platform/windows.html.en or
73 http://httpd.apache.org/docs/2.4/platform/windows.html.
75 The Apache/Win32 binaries are distributed as Windows Installer packages
76 (.msi) named httpd-2.4.xx-win32-x86-no_ssl.msi for a version without mod_ssl
77 and httpd-2.4.xx-win32-x86-openssl-1.0.1x.msi for a version including the
78 mod_ssl plus the openssl library and command line utility. Additional 64 bit
79 binaries have similarly named -win64-x64 package names. These packages
80 may be unpacked without "installing" them by using the msiexec /a option.
82 If you have unpacked a source distribution (named httpd-2.4.x-win32-src.zip,
83 without any -x86 or -x64 notation) you must compile the package yourself,
84 see the links mentioned above. Unless you intended to do this, please look
85 again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/
86 and install that desired .msi package.
88 The .msi package configures the httpd.conf file, and installs and starts
89 the Apache2.4 service for you. It also installs plenty of useful shortcuts
90 and the taskbar ApacheMonitor. We strongly encourage you to use it.
96 The Apache HTTP Server group cannot field user's installation questions.
97 There are many valuable forums to help you get started. Please refer your
98 questions to the appropriate forum, such as the Users Mailing List at
99 http://httpd.apache.org/userslist.html or the usenet newsgroups
100 comp.infosystems.www.servers.unix or
101 comp.infosystems.www.servers.ms-windows.
103 Thanks for using the Apache HTTP Server, version 2.4.
105 The Apache Software Foundation
106 http://www.apache.org/