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.1/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             * If you are building on FreeBSD, be aware that threads will
  21               be disabled and the prefork MPM will be used by default,
  22               as threads do not work well with Apache on FreeBSD.  If
  23               you wish to try a threaded Apache on FreeBSD anyway, use
  24               "./configure --enable-threads".
  25
  26             * If you are building on Mac OS X (Darwin), make sure to
  27               use libtool 1.4.2 or newer.
  28
  29             * If you are a developer building Apache directly from CVS,
  30               you will need to run ./buildconf before running configure.
  31
  32   For a short impression of what possibilities you have, here is a
  33   typical example which configures Apache for the installation tree
  34   /sw/pkg/apache with a particular compiler and flags plus the two
  35   additional modules mod_rewrite and mod_speling for later loading
  36   through the DSO mechanism:
  37
  38      $ CC="pgcc" CFLAGS="-O2" \
  39      ./configure --prefix=/sw/pkg/apache \
  40      --enable-rewrite=shared \
  41      --enable-speling=shared
  42
  43   The easiest way to find all of the configuration flags for Apache 2.1
  44   is to run ./configure --help.
  45
  46
  47   Quick Start - Windows
  48   ---------------------
  49
  50   For complete documentation, see [ht]docs/manual/platform/windows.html or
  51   http://httpd.apache.org/docs-2.1/platform/windows.html.
  52
  53   The Apache/Win32 binaries are primarily distributed as a Windows Installer
  54   package (.msi), and may be available as a .zip file as well.  These packages
  55   are named apache-2.1.xx-win32-x86.msi and apache-2.1.xx-win32-x86.zip.
  56   Please choose the .msi package if at all possible.
  57
  58   If you have unpacked a source distribution (named httpd-2.1-xx.zip, without
  59   any -win32-x86 notation) you must compile the package yourself, see the links
  60   mentioned above.  Unless you intended to do this, please look again for the
  61   binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
  62   install that .msi (or .zip package, if you must.)
  63
  64   If you have unpacked this binary distribution from the .zip package, you
  65   _must_ edit the conf/httpd.conf file (with notepad or another text editor)
  66   to reflect the correct ServerName, Domain, and directory paths.  Search for
  67   the text "@@" to discover what you must edit.  To install and start the
  68   service after you have corrected the httpd.conf file, use the command
  69
  70     bin\Apache -k install
  71     bin\Apache -k start
  72
  73   The .msi package configures the httpd.conf file, and installs and starts
  74   the Apache2 service for you.  It also installs plenty of useful shortcuts
  75   and the taskbar ApacheMonitor.  We strongly encourage you to use it.
  76
  77
  78   Postscript
  79   ----------
  80
  81   The Apache HTTP Server group cannot field user's installation questions.
  82   There are many valuable forums to help you get started.  Please refer your
  83   questions to the appropriate forum, such as the Users Mailing List at
  84   http://httpd.apache.org/userslist.html or the usenet newsgroups
  85   comp.infosystems.www.servers.unix or
  86   comp.infosystems.www.servers.ms-windows.
  87
  88   Thanks for using the Apache HTTP Server, version 2.1.
  89
  90                                      The Apache Software Foundation
  91                                      http://www.apache.org/