INSTALL revision da5228d14ea8b4afcaa9f8e7b79e5aa87008afbe
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek APACHE INSTALLATION OVERVIEW
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek Quick Start - Unix
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek ------------------
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek For complete installation documentation, see [ht]docs/manual/install.html or
4182b3a1f9f6e1823db9832533c6c9e51d13da8eJakub Hrozek $ ./configure --prefix=PREFIX
4182b3a1f9f6e1823db9832533c6c9e51d13da8eJakub Hrozek $ make install
9e80079370ff3b943832adc3c5ef430e64be0a0cJakub Hrozek NOTES: * Replace PREFIX with the filesystem path under which
9e80079370ff3b943832adc3c5ef430e64be0a0cJakub Hrozek Apache should be installed. A typical installation
9e80079370ff3b943832adc3c5ef430e64be0a0cJakub Hrozek might use "/usr/local/apache2" for PREFIX (without the
af5a58fc3811af8521721f731d8234d983042ceaJan Cholasta * Consider if you want to use a previously installed APR and
a8781a38b5fca84647d59199fd0b0b4b2d4624e0Sumit Bose APR-Util (such as those provided with many OSes) or if
a8781a38b5fca84647d59199fd0b0b4b2d4624e0Sumit Bose you need to use the APR and APR-Util from the
a8781a38b5fca84647d59199fd0b0b4b2d4624e0Sumit Bose httpd-2.5.x-deps.tar.gz tarball via ./configure's
cb4d5b588e704114b7090678752d33512baa718eJakub Hrozek --with-included-apr option. This is required if you don't
cb4d5b588e704114b7090678752d33512baa718eJakub Hrozek have the compiler which the system APR was built with. It
cb4d5b588e704114b7090678752d33512baa718eJakub Hrozek can also be advantageous if you are a developer who will be
54c64aad71e6792edb7cf99988d9a7f4bc2b0c61Jakub Hrozek linking your code with Apache or using a debugger to step
54c64aad71e6792edb7cf99988d9a7f4bc2b0c61Jakub Hrozek through server code, as it removes the possibility of
54c64aad71e6792edb7cf99988d9a7f4bc2b0c61Jakub Hrozek version or compile-option mismatches with APR and APR-util
ba89271f594e5ed381b4dcb876a2d2787cf51902Jakub Hrozek * If you are a developer building Apache directly from
f199c749197532fd3380fa6f5d9f7a579879c21aJustin Stephenson Subversion, you will need to run ./buildconf before running
f199c749197532fd3380fa6f5d9f7a579879c21aJustin Stephenson configure. This script bootstraps the build environment and
f199c749197532fd3380fa6f5d9f7a579879c21aJustin Stephenson requires Python as well as GNU autoconf and libtool. If you
772464c842968d6e544118ae1aa7c49a7cda2ad6Stephen Gallagher build Apache from a release tarball, you don't have to run
772464c842968d6e544118ae1aa7c49a7cda2ad6Stephen Gallagher * If you want to build a threaded MPM (for instance worker)
772464c842968d6e544118ae1aa7c49a7cda2ad6Stephen Gallagher on FreeBSD, be aware that threads do not work well with
9cd29d64f1c556fd222491a34229393b4462f126Fabiano Fidêncio Apache on FreeBSD versions before 5.4-RELEASE. If you wish
9cd29d64f1c556fd222491a34229393b4462f126Fabiano Fidêncio to try a threaded Apache on an earlier version of FreeBSD,
9cd29d64f1c556fd222491a34229393b4462f126Fabiano Fidêncio use the --enable-threads parameter to ./configure in
78bb3676fe8326e0fe2b60daad8bf524e4625d4eJakub Hrozek addition to the --with-mpm parameter.
78bb3676fe8326e0fe2b60daad8bf524e4625d4eJakub Hrozek * If you are building directly from Subversion on Mac OS X
78bb3676fe8326e0fe2b60daad8bf524e4625d4eJakub Hrozek (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
78bb3676fe8326e0fe2b60daad8bf524e4625d4eJakub Hrozek recent versions of the developer tools on this platform
f199c749197532fd3380fa6f5d9f7a579879c21aJustin Stephenson include a sufficiently recent version of GNU Libtool (named
9e80079370ff3b943832adc3c5ef430e64be0a0cJakub Hrozek glibtool, but buildconf knows where to find it).
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek For a short impression of what possibilities you have, here is a
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek typical example which configures Apache for the installation tree
4d81fe27ced3d2e96866aeaf61661a925cb8edf1Jakub Hrozek /sw/pkg/apache with a particular compiler and flags plus the two
4d81fe27ced3d2e96866aeaf61661a925cb8edf1Jakub Hrozek additional modules mod_rewrite and mod_speling for later loading
b772ceb6e5cdda62aa98d4fc61f4800b9779b74aLukas Slebodnik through the DSO mechanism:
4d81fe27ced3d2e96866aeaf61661a925cb8edf1Jakub Hrozek $ CC="pgcc" CFLAGS="-O2" \
4d81fe27ced3d2e96866aeaf61661a925cb8edf1Jakub Hrozek ./configure --prefix=/sw/pkg/apache \
4d81fe27ced3d2e96866aeaf61661a925cb8edf1Jakub Hrozek --enable-rewrite=shared \
4d81fe27ced3d2e96866aeaf61661a925cb8edf1Jakub Hrozek --enable-speling=shared
9675aa73c7cb0c918038a7e177895b67ce135bedStephen Gallagher The easiest way to find all of the configuration flags for Apache 2.5
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek is to run ./configure --help.
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek Quick Start - Windows
db36dca3d45e6eefbb30042ee65876566f1a6014Sumit Bose ---------------------
97216f0129366ac4850f62dac104b8d280ba517aNoam Meltzer For complete documentation, see [ht]docs/manual/platform/windows.html or
27c30eb5f046d6c43276b139706110906cdacb9bNikolai Kondrashov http://httpd.apache.org/docs/2.5/platform/windows.html.
9675aa73c7cb0c918038a7e177895b67ce135bedStephen Gallagher The Apache/Win32 binaries are primarily distributed as a Windows Installer
4b9c236008b35d2155b94635a236ce7770db4728Nikolai Kondrashov package (.msi), and may be available as a .zip file as well. These packages
4b9c236008b35d2155b94635a236ce7770db4728Nikolai Kondrashov are named apache-2.5.xx-win32-x86.msi and apache-2.5.xx-win32-x86.zip.
4b9c236008b35d2155b94635a236ce7770db4728Nikolai Kondrashov Please choose the .msi package if at all possible. Note that Apache version
4b9c236008b35d2155b94635a236ce7770db4728Nikolai Kondrashov 2.5 is a development version and binaries may not be available. Use a
2ebb3cf3d7062860343c3db1b53173c9c6547038Jan Cholasta released version from the stable 2.2 branch instead.
2ebb3cf3d7062860343c3db1b53173c9c6547038Jan Cholasta If you have unpacked a source distribution (named httpd-2.5-xx.zip, without
6f51c802311fd81a409a26763ed45b28a3234d0dJakub Hrozek any -win32-x86 notation) you must compile the package yourself, see the links
8a2a49333b7df3a4b86db42cd20ec8286d2788d3Pavel Březina mentioned above. Unless you intended to do this, please look again for the
8a2a49333b7df3a4b86db42cd20ec8286d2788d3Pavel Březina binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
8a2a49333b7df3a4b86db42cd20ec8286d2788d3Pavel Březina install that .msi (or .zip package, if you must.)
cb4d5b588e704114b7090678752d33512baa718eJakub Hrozek If you have unpacked this binary distribution from the .zip package, you
cb4d5b588e704114b7090678752d33512baa718eJakub Hrozek _must_ edit the conf/httpd.conf file (with notepad or another text editor)
cb4d5b588e704114b7090678752d33512baa718eJakub Hrozek to reflect the correct ServerName, Domain, and directory paths. Search for
cb4d5b588e704114b7090678752d33512baa718eJakub Hrozek the text "@@" to discover what you must edit. To install and start the
54c64aad71e6792edb7cf99988d9a7f4bc2b0c61Jakub Hrozek service after you have corrected the httpd.conf file, use the command
54c64aad71e6792edb7cf99988d9a7f4bc2b0c61Jakub Hrozek bin\httpd.exe -k install
ba89271f594e5ed381b4dcb876a2d2787cf51902Jakub Hrozek The .msi package configures the httpd.conf file, and installs and starts
ba89271f594e5ed381b4dcb876a2d2787cf51902Jakub Hrozek the Apache2 service for you. It also installs plenty of useful shortcuts
ba89271f594e5ed381b4dcb876a2d2787cf51902Jakub Hrozek and the taskbar ApacheMonitor. We strongly encourage you to use it.
38e8362ba7b0403527403d79b36d03a5dbd621acJakub Hrozek The Apache HTTP Server group cannot field user's installation questions.
38e8362ba7b0403527403d79b36d03a5dbd621acJakub Hrozek There are many valuable forums to help you get started. Please refer your
38e8362ba7b0403527403d79b36d03a5dbd621acJakub Hrozek questions to the appropriate forum, such as the Users Mailing List at
da95ec568a941c85982e30611398efb86bc884abJakub Hrozek http://httpd.apache.org/userslist.html or the usenet newsgroups