1 2 APACHE INSTALLATION OVERVIEW 3 4 Quick Start - Unix 5 ------------------ 6 7 For complete installation documentation, see [ht]docs/manual/install.html or 8 http://httpd.apache.org/docs/2.4/install.html 9 10 $ ./configure --prefix=PREFIX 11 $ make 12 $ make install 13 $ PREFIX/bin/apachectl start 14 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 18 quotes). 19 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 32 and APR-Util code. As a convenience, prepackaged source-code 33 bundles of APR and APR-Util are occasionally also provided 34 as a httpd-2.X.X-deps.tar.gz download. 35 36 * If you are a developer building Apache directly from 37 Subversion, you will need to run ./buildconf before running 38 configure. This script bootstraps the build environment and 39 requires Python as well as GNU autoconf and libtool. If you 40 build Apache from a release tarball, you don't have to run 41 buildconf. 42 43 * If you want to build a threaded MPM (for instance worker) 44 on FreeBSD, be aware that threads do not work well with 45 Apache on FreeBSD versions before 5.4-RELEASE. If you wish 46 to try a threaded Apache on an earlier version of FreeBSD, 47 use the --enable-threads parameter to ./configure in 48 addition to the --with-mpm parameter. 49 50 * If you are building directly from Subversion on Mac OS X 51 (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All 52 recent versions of the developer tools on this platform 53 include a sufficiently recent version of GNU Libtool (named 54 glibtool, but buildconf knows where to find it). 55 56 For a short impression of what possibilities you have, here is a 57 typical example which configures Apache for the installation tree 58 /sw/pkg/apache with a particular compiler and flags plus the two 59 additional modules mod_rewrite and mod_speling for later loading 60 through the DSO mechanism: 61 62 $ CC="pgcc" CFLAGS="-O2" \ 63 ./configure --prefix=/sw/pkg/apache \ 64 --enable-rewrite=shared \ 65 --enable-speling=shared 66 67 The easiest way to find all of the configuration flags for Apache 2.4 68 is to run ./configure --help. 69 70 71 Quick Start - Windows 72 --------------------- 73 74 For complete documentation, see manual/platform/windows.html.en or 75 http://httpd.apache.org/docs/2.4/platform/windows.html. 76 77 The Apache/Win32 binaries are distributed as Windows Installer packages 78 (.msi) named httpd-2.4.xx-win32-x86-no_ssl.msi for a version without mod_ssl 79 and httpd-2.4.xx-win32-x86-openssl-1.0.1x.msi for a version including the 80 mod_ssl plus the openssl library and command line utility. Additional 64 bit 81 binaries have similarly named -win64-x64 package names. These packages 82 may be unpacked without "installing" them by using the msiexec /a option. 83 84 If you have unpacked a source distribution (named httpd-2.4.x-win32-src.zip, 85 without any -x86 or -x64 notation) you must compile the package yourself, 86 see the links mentioned above. Unless you intended to do this, please look 87 again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/ 88 and install that desired .msi package. 89 90 The .msi package configures the httpd.conf file, and installs and starts 91 the Apache2.4 service for you. It also installs plenty of useful shortcuts 92 and the taskbar ApacheMonitor. We strongly encourage you to use it. 93 94 95 Postscript 96 ---------- 97 98 To obtain help with installation problems, please see the resources at 99 <http://httpd.apache.org/support.html> 100 101 Thanks for using the Apache HTTP Server, version 2.4. 102 103 The Apache Software Foundation 104 http://www.apache.org/ 105