You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2026/05/26 10:11:22 UTC
svn commit: r1934637 - httpd/httpd/trunk/docs/manual
Author: rbowen
Date: Tue May 26 10:11:21 2026
New Revision: 1934637
Log:
docs: Modernize install.xml
- Remove mirrors reference and binary releases (both retired)
- Update all external links to https
- Update version examples to current 2.4.66/2.4.67
- Replace two-step gzip/tar with single tar xzf
- Reword download section for source builds
- Consolidate verification link to verification.html
- Remove minimizing language (easy, simple, simply)
- Add language="sh" to all highlight blocks
- Update disk space: 200 MB build (was 50), 50 MB installed (was 10)
- Replace deprecated ntpdate/xntpd with systemd-timesyncd/chrony
- Remove outdated Perl 5.003 version floor
- Update release examples from dead 2.0/2.2 to 2.4/2.6
- Update 'Mac OS X, Solaris' to 'macOS'
- Requirements intro: 'building' → 'building and running'
Modified:
httpd/httpd/trunk/docs/manual/install.xml
Modified: httpd/httpd/trunk/docs/manual/install.xml
==============================================================================
--- httpd/httpd/trunk/docs/manual/install.xml Tue May 26 09:35:20 2026 (r1934636)
+++ httpd/httpd/trunk/docs/manual/install.xml Tue May 26 10:11:21 2026 (r1934637)
@@ -40,7 +40,7 @@
projects.</p>
<p>If you are upgrading from one minor version to the next (for
- example, 2.4.8 to 2.4.9), please skip down to the <a
+ example, 2.4.66 to 2.4.67), please skip down to the <a
href="#upgrading">upgrading</a> section.</p>
</summary>
@@ -55,7 +55,7 @@
<dl>
<dt>Installing on Fedora/CentOS/Red Hat Enterprise Linux</dt>
<dd>
- <highlight>
+ <highlight language="sh">
sudo dnf install httpd
# Start service
@@ -75,7 +75,7 @@ sudo systemctl restart httpd
<dt>Installing on Ubuntu/Debian</dt>
<dd>
-<highlight>
+<highlight language="sh">
sudo apt install apache2
# Start service
@@ -99,16 +99,17 @@ sudo systemctl restart apache2
<tr>
<td><a href="#download">Download</a></td>
- <td>Download the latest release from <a href="http://httpd.apache.org/download.cgi#apache24">http://httpd.apache.org/download.cgi</a>
+ <td>Download the latest release from <a href="https://httpd.apache.org/download.cgi#apache24">https://httpd.apache.org/download.cgi</a>
</td>
</tr>
<tr>
<td><a href="#extract">Extract</a></td>
- <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
- $ tar xvf httpd-<em>NN</em>.tar<br />
- $ cd httpd-<em>NN</em></code></td>
+ <td><highlight language="sh">
+$ tar xzf httpd-NN.tar.gz
+$ cd httpd-NN
+</highlight></td>
</tr>
<tr>
@@ -157,21 +158,21 @@ sudo systemctl restart apache2
</dl>
<note type="warning">Don't see your favorite platform mentioned
- here? <a href="http://httpd.apache.org/docs-project/">Come help us
+ here? <a href="https://httpd.apache.org/docs-project/">Come help us
improve this doc.</a></note>
</section>
<section id="requirements"><title>Requirements</title>
- <p>The following requirements exist for building Apache httpd:</p>
+ <p>The following requirements exist for building and running Apache httpd:</p>
<dl>
<dt>APR and APR-Util</dt>
<dd>Make sure you have APR and APR-Util already installed on
your system. If you don't, or prefer to not use the system-provided
versions, download the latest versions of both APR and APR-Util
- from <a href="http://apr.apache.org/">Apache APR</a>, unpack
+ from <a href="https://apr.apache.org/">Apache APR</a>, unpack
them into <code>/httpd_source_tree_root/srclib/apr</code> and <code>/httpd_source_tree_root/srclib/apr-util</code>
(be sure the directory names do not have version numbers; for example,
the APR distribution must be under /httpd_source_tree_root/srclib/apr/) and use
@@ -182,7 +183,7 @@ sudo systemctl restart apache2
<dt>Perl-Compatible Regular Expressions Library (PCRE)</dt>
<dd>This library is required but no longer bundled with httpd.
- Download the source code from <a href="http://www.pcre.org/">http://www.pcre.org</a>,
+ Download the source code from <a href="https://www.pcre.org/">https://www.pcre.org</a>,
or install a Port or Package. If your build system can't find
the pcre-config script installed by the PCRE build, point to it
using the <code>--with-pcre</code> parameter. On some platforms,
@@ -191,18 +192,18 @@ sudo systemctl restart apache2
of PCRE.</dd>
<dt>Disk Space</dt>
- <dd>Make sure you have at least 50 MB of temporary free disk
+ <dd>Make sure you have at least 200 MB of temporary free disk
space available. After installation the server occupies
- approximately 10 MB of disk space. The actual disk space
+ approximately 50 MB of disk space. The actual disk space
requirements will vary considerably based on your chosen
configuration options, any third-party modules, and, of course,
the size of the web site or sites that you have on the server.</dd>
<dt>ANSI-C Compiler and Build System</dt>
<dd>Make sure you have an ANSI-C compiler installed. The <a
- href="http://gcc.gnu.org/">GNU C
+ href="https://gcc.gnu.org/">GNU C
compiler (GCC)</a> from the <a
- href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
+ href="https://www.gnu.org/">Free Software Foundation (FSF)</a>
is recommended. If you don't have GCC
then at least make sure your vendor's compiler is ANSI
compliant. In addition, your <code>PATH</code> must contain
@@ -211,19 +212,18 @@ sudo systemctl restart apache2
<dt>Accurate time keeping</dt>
<dd>Elements of the HTTP protocol are expressed as the time of
day. So, it's time to investigate setting some time
- synchronization facility on your system. Usually the
- <code>ntpdate</code> or <code>xntpd</code> programs are used for
- this purpose which are based on the Network Time Protocol (NTP).
- See the <a href="http://www.ntp.org">NTP
+ synchronization facility on your system. Most modern Linux
+ distributions provide <code>systemd-timesyncd</code> or
+ <code>chrony</code> for this purpose. See the <a href="https://www.ntp.org">NTP
homepage</a> for more details about NTP software and public
time servers.</dd>
- <dt><a href="http://www.perl.org/">Perl 5</a>
+ <dt><a href="https://www.perl.org/">Perl 5</a>
[OPTIONAL]</dt>
<dd>For some of the support scripts like <program>
apxs</program> or <program>dbmmanage</program> (which are
- written in Perl) the Perl 5 interpreter is required (versions
- 5.003 or newer are sufficient). If no Perl 5 interpreter is found by the
+ written in Perl) the Perl 5 interpreter is required.
+ If no Perl 5 interpreter is found by the
<program>configure</program> script, you will not be able to use
the affected support scripts. Of course, you will still be able to
build and use Apache httpd.</dd>
@@ -232,36 +232,29 @@ sudo systemctl restart apache2
<section id="download"><title>Download</title>
- <p>The Apache HTTP Server can be downloaded from the <a
- href="http://httpd.apache.org/download.cgi">Apache HTTP Server
- download site</a>, which lists several mirrors. Most users of
- Apache on unix-like systems will be better off downloading and
- compiling a source version. The build process (described below) is
- easy, and it allows you to customize your server to suit your needs.
- In addition, binary releases are often not up to date with the latest
- source releases. If you do download a binary, follow the instructions
- in the <code>INSTALL.bindist</code> file inside the distribution.</p>
+ <p>If you wish to build from source, start by downloading
+ the source tarball from the <a
+ href="https://httpd.apache.org/download.cgi">Apache HTTP Server
+ download site</a>. The build process (described below)
+ allows you to customize your server to suit your
+ needs.</p>
<p>After downloading, it is important to verify that you have a
complete and unmodified version of the Apache HTTP Server. This
can be accomplished by testing the downloaded tarball against the
- PGP signature. Details on how to do this are available on the <a
- href="http://httpd.apache.org/download.cgi#verify">download
- page</a> and an extended example is available describing the <a
- href="http://httpd.apache.org/dev/verification.html">use of
- PGP</a>.</p>
+ PGP signature. Details on how to do this are available on the
+ <a href="https://httpd.apache.org/dev/verification.html">verification
+ page</a>.</p>
</section>
<section id="extract"><title>Extract</title>
- <p>Extracting the source from the Apache HTTP Server tarball is a
- simple matter of uncompressing, and then untarring:</p>
+ <p>Extract the source from the Apache HTTP Server tarball:</p>
<example>
<highlight language="sh">
-$ gzip -d httpd-<em>NN</em>.tar.gz
-$ tar xvf httpd-<em>NN</em>.tar
+$ tar xzf httpd-<em>NN</em>.tar.gz
</highlight>
</example>
@@ -283,7 +276,7 @@ $ tar xvf httpd-<em>NN</em>.tar
steps. This is not necessary for official releases.)</p>
<p>To configure the source tree using all the default options,
- simply type <code>./configure</code>. To change the default
+ type <code>./configure</code>. To change the default
options, <program>configure</program> accepts a variety of variables
and command line options.</p>
@@ -311,8 +304,7 @@ $ tar xvf httpd-<em>NN</em>.tar
to a dash. Similarly, you can disable modules with the
<code>--disable-<var>module</var></code> option. Be careful when
using these options, since <program>configure</program> cannot warn you
- if the module you specify does not exist; it will simply ignore the
- option.</p>
+ if the module you specify does not exist; it will ignore the option.</p>
<p>In addition, it is sometimes necessary to provide the
<program>configure</program> script with extra information about the
@@ -348,7 +340,7 @@ $ CC="pgcc" CFLAGS="-O2" \
<section id="compile"><title>Build</title>
<p>Now you can build the various parts which form the Apache
- package by simply running the command:</p>
+ package by running:</p>
<example>$ make</example>
@@ -384,8 +376,8 @@ $ CC="pgcc" CFLAGS="-O2" \
<p>Have a look at the Apache manual under
<code><em>PREFIX</em>/docs/manual/</code> or consult <a
- href="http://httpd.apache.org/docs/&httpd.docs;/"
- >http://httpd.apache.org/docs/&httpd.docs;/</a> for the most recent
+ href="https://httpd.apache.org/docs/&httpd.docs;/"
+ >https://httpd.apache.org/docs/&httpd.docs;/</a> for the most recent
version of this manual and a complete reference of available <a
href="mod/directives.html">configuration directives</a>.</p>
</section>
@@ -411,14 +403,14 @@ $ CC="pgcc" CFLAGS="-O2" \
<p>The first step in upgrading is to read the release announcement
and the file <code>CHANGES</code> in the source distribution to
find any changes that may affect your site. When changing between
- major releases (for example, from 2.0 to 2.2 or from 2.2 to 2.4),
+ major releases (for example, from 2.4 to 2.6),
there will likely be major differences in the compile-time and
run-time configuration that will require manual adjustments. All
modules will also need to be upgraded to accommodate changes in the
module API.</p>
<p>Upgrading from one minor version to the next (for example, from
- 2.2.55 to 2.2.57) is easier. The <code>make install</code>
+ 2.4.66 to 2.4.67) is easier. The <code>make install</code>
process will not overwrite any of your existing documents, log
files, or configuration files. In addition, the developers make
every effort to avoid incompatible changes in the
@@ -469,8 +461,7 @@ $ <em>PREFIX</em>/bin/apachectl -k start
<p>A large number of third parties provide their own packaged
distributions of the Apache HTTP Server for installation on
particular platforms. This includes the various Linux distributions,
- various third-party Windows packages, Mac OS X, Solaris, and many
- more.</p>
+ various third-party Windows packages, macOS, and many more.</p>
<p>Our software license not only permits, but encourages, this kind
of redistribution. However, it does result in a situation where the