2 APACHE INSTALLATION OVERVIEW
7 For complete installation documentation, see [ht]docs/manual/install.html or
8 http://httpd.apache.org/docs/2.3/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 * If you are a developer who will be linking your code with
21 Apache or using a debugger to step through server code,
22 ./configure's --with-included-apr option may be advantageous,
23 as it removes the possibility of version or compile-option
24 mismatches with APR and APR-util code. (Many OSes now
25 include their own version of APR and APR-util.)
27 * If you are a developer building Apache directly from
28 Subversion, you will need to run ./buildconf before running
29 configure. This script bootstraps the build environment and
30 requires Python as well as GNU autoconf and libtool. If you
31 build Apache from a release tarball, you don't have to run
34 * If you want to build a threaded MPM (for instance worker)
35 on FreeBSD, be aware that threads do not work well with
36 Apache on FreeBSD versions before 5.4-RELEASE. If you wish
37 to try a threaded Apache on an earlier version of FreeBSD,
38 use the --enable-threads parameter to ./configure in
39 addition to the --with-mpm parameter.
41 * If you are building directly from Subversion on Mac OS X
42 (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
43 recent versions of the developer tools on this platform
44 include a sufficiently recent version of GNU Libtool (named
45 glibtool, but buildconf knows where to find it).
47 For a short impression of what possibilities you have, here is a
48 typical example which configures Apache for the installation tree
49 /sw/pkg/apache with a particular compiler and flags plus the two
50 additional modules mod_rewrite and mod_speling for later loading
51 through the DSO mechanism:
53 $ CC="pgcc" CFLAGS="-O2" \
54 ./configure --prefix=/sw/pkg/apache \
55 --enable-rewrite=shared \
56 --enable-speling=shared
58 The easiest way to find all of the configuration flags for Apache 2.3
59 is to run ./configure --help.
65 For complete documentation, see [ht]docs/manual/platform/windows.html or
66 http://httpd.apache.org/docs/2.3/platform/windows.html.
68 The Apache/Win32 binaries are primarily distributed as a Windows Installer
69 package (.msi), and may be available as a .zip file as well. These packages
70 are named apache-2.3.xx-win32-x86.msi and apache-2.3.xx-win32-x86.zip.
71 Please choose the .msi package if at all possible. Note that Apache version
72 2.3 is a development version and binaries may not be available. Use a
73 released version from the stable 2.2 branch instead.
75 If you have unpacked a source distribution (named httpd-2.3-xx.zip, without
76 any -win32-x86 notation) you must compile the package yourself, see the links
77 mentioned above. Unless you intended to do this, please look again for the
78 binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
79 install that .msi (or .zip package, if you must.)
81 If you have unpacked this binary distribution from the .zip package, you
82 _must_ edit the conf/httpd.conf file (with notepad or another text editor)
83 to reflect the correct ServerName, Domain, and directory paths. Search for
84 the text "@@" to discover what you must edit. To install and start the
85 service after you have corrected the httpd.conf file, use the command
87 bin\httpd.exe -k install
88 bin\httpd.exe -k start
90 The .msi package configures the httpd.conf file, and installs and starts
91 the Apache2 service for you. It also installs plenty of useful shortcuts
92 and the taskbar ApacheMonitor. We strongly encourage you to use it.
98 The Apache HTTP Server group cannot field user's installation questions.
99 There are many valuable forums to help you get started. Please refer your
100 questions to the appropriate forum, such as the Users Mailing List at
101 http://httpd.apache.org/userslist.html or the usenet newsgroups
102 comp.infosystems.www.servers.unix or
103 comp.infosystems.www.servers.ms-windows.
105 Thanks for using the Apache HTTP Server, version 2.3.
107 The Apache Software Foundation
108 http://www.apache.org/