INSTALL

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