APACHE INSTALLATION OVERVIEW Quick Start - Unix ------------------ For complete installation documentation, see [ht]docs/manual/install.html or http://httpd.apache.org/docs/2.5/install.html $ ./configure --prefix=PREFIX $ make $ make install $ PREFIX/bin/apachectl start NOTES: * Replace PREFIX with the filesystem path under which Apache should be installed. A typical installation might use "/usr/local/apache2" for PREFIX (without the quotes). * Consider if you want to use a previously installed APR and APR-Util (such as those provided with many OSes) or if you need to use the APR and APR-Util from the httpd-2.5.x-deps.tar.gz tarball via ./configure's --with-included-apr option. This is required if you don't have the compiler which the system APR was built with. It can also be advantageous if you are a developer who will be linking your code with Apache or using a debugger to step through server code, as it removes the possibility of version or compile-option mismatches with APR and APR-util code. * If you are a developer building Apache directly from Subversion, you will need to run ./buildconf before running configure. This script bootstraps the build environment and requires Python as well as GNU autoconf and libtool. If you build Apache from a release tarball, you don't have to run buildconf. * If you want to build a threaded MPM (for instance worker) on FreeBSD, be aware that threads do not work well with Apache on FreeBSD versions before 5.4-RELEASE. If you wish to try a threaded Apache on an earlier version of FreeBSD, use the --enable-threads parameter to ./configure in addition to the --with-mpm parameter. * If you are building directly from Subversion on Mac OS X (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All recent versions of the developer tools on this platform include a sufficiently recent version of GNU Libtool (named glibtool, but buildconf knows where to find it). For a short impression of what possibilities you have, here is a typical example which configures Apache for the installation tree /sw/pkg/apache with a particular compiler and flags plus the two additional modules mod_rewrite and mod_speling for later loading through the DSO mechanism: $ CC="pgcc" CFLAGS="-O2" \ ./configure --prefix=/sw/pkg/apache \ --enable-rewrite=shared \ --enable-speling=shared The easiest way to find all of the configuration flags for Apache 2.5 is to run ./configure --help. Quick Start - Windows --------------------- For complete documentation, see manual/platform/windows.html.en or http://httpd.apache.org/docs/2.5/platform/windows.html. The Apache/Win32 binaries are distributed as Windows Installer packages (.msi) named httpd-2.5.xx-win32-x86-no_ssl.msi for a version without mod_ssl and httpd-2.5.xx-win32-x86-openssl-1.0.1x.msi for a version including the mod_ssl plus the openssl library and command line utility. Additional 64 bit binaries have similarly named -win64-x64 package names. These packages may be unpacked without "installing" them by using the msiexec /a option. If you have unpacked a source distribution (named httpd-2.5.x-win32-src.zip, without any -x86 or -x64 notation) you must compile the package yourself, see the links mentioned above. Unless you intended to do this, please look again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/ and install that desired .msi package. The .msi package configures the httpd.conf file, and installs and starts the Apache2.x service for you. It also installs plenty of useful shortcuts and the taskbar ApacheMonitor. We strongly encourage you to use it. Postscript ---------- The Apache HTTP Server group cannot field user's installation questions. There are many valuable forums to help you get started. Please refer your questions to the appropriate forum, such as the Users Mailing List at http://httpd.apache.org/userslist.html or the usenet newsgroups comp.infosystems.www.servers.unix or comp.infosystems.www.servers.ms-windows. Thanks for using the Apache HTTP Server, version 2.5. The Apache Software Foundation http://www.apache.org/