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   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   The Apache HTTP Server group cannot field user's installation questions.
  99   There are many valuable forums to help you get started.  Please refer your
 100   questions to the appropriate forum, such as the Users Mailing List at
 101   http://httpd.apache.org/userslist.html or the usenet newsgroups
 102   comp.infosystems.www.servers.unix or
 103   comp.infosystems.www.servers.ms-windows.
 104
 105   Thanks for using the Apache HTTP Server, version 2.4.
 106
 107                                      The Apache Software Foundation
 108                                      http://www.apache.org/