granicus.if.org Git - apache/blob - 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.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
  78   Postscript
  79   ----------
  80
  81   To obtain help with installation problems, please see the resources at
  82   <http://httpd.apache.org/support.html>
  83
  84   Thanks for using the Apache HTTP Server, version 2.4.
  85
  86                                      The Apache Software Foundation
  87                                      http://www.apache.org/