<!--
  Copyright (C) Igor Sysoev
  Copyright (C) Nginx, Inc.
  -->

<!DOCTYPE article SYSTEM "../../dtd/article.dtd">

<article name="nginx: download"
         link="/en/download.html"
         lang="en"
         rev="1">


<section name="Development version">

<download last="1" tag="development" />

</section>


<section name="Stable version">

<download last="1" tag="stable" />

</section>


<section name="Legacy versions">

<download last="1" tag="legacy" />

</section>


<section name="Source Code">

<para>
Read-only Subversion repositories:
<list type="bullet">

<listitem>
code: <literal>svn://svn.nginx.org/nginx</literal>
</listitem>

</list>

Read-only Mercurial repositories:
<list type="bullet">

<listitem>
site: <literal>http://hg.nginx.org/nginx.org</literal>
</listitem>

</list>
</para>

<para>
<link url="http://trac.nginx.org/nginx/browser">Trac source browser</link>
</para>

</section>


<section name="Pre-Built Linux Packages for Stable">

<para>
To enable automatic updates of Linux packages
set up the yum repository for the RHEL/CentOS distributions,
or the apt repository for the Debian/Ubuntu distributions.
</para>

<para>
To set up the yum repository for RHEL/CentOS, choose the corresponding
<literal>nginx-release</literal> package from the list:

<list type="bullet">

<listitem>
<link url="http://nginx.org/packages/rhel/5/noarch/RPMS/nginx-release-rhel-5-0.el5.ngx.noarch.rpm">RHEL 5</link>
</listitem>

<listitem>
<link url="http://nginx.org/packages/rhel/6/noarch/RPMS/nginx-release-rhel-6-0.el6.ngx.noarch.rpm">RHEL 6</link>
</listitem>

<listitem>
<link url="http://nginx.org/packages/centos/5/noarch/RPMS/nginx-release-centos-5-0.el5.ngx.noarch.rpm">CentOS 5</link>
</listitem>

<listitem>
<link url="http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm">CentOS 6</link>
</listitem>

</list>

This package contains yum configuration file
and a public PGP key necessary to authenticate signed RPMs.
Download and install it, then run the following:
<programlisting>
yum install nginx
</programlisting>

Alternatively, a repository configuration can be added manually
without installing the <literal>nginx-release</literal> package.
Create the file named <path>/etc/yum.repos.d/nginx.repo</path>
with the following contents:

<programlisting>
[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/OS/OSRELEASE/$basearch/
gpgcheck=0
enabled=1
</programlisting>

Replace “<literal>OS</literal>” with “<literal>rhel</literal>” or
“<literal>centos</literal>”,
depending on the distribution used, and “<literal>OSRELEASE</literal>”
with “<literal>5</literal>” or “<literal>6</literal>”,
for 5.x or 6.x versions, respectively.
</para>

<para>
For Debian/Ubuntu, in order to authenticate the nginx repository signature
and to eliminate warnings about missing gpg key during installation of the
nginx package, it is necessary to add the key used to sign the nginx
packages and repository to the <command>apt</command> program keyring.
Please download <link url="http://nginx.org/keys/nginx_signing.key">this
key</link> from our web site, and add it to the <command>apt</command>
program keyring with the following command:
<programlisting>
sudo apt-key add nginx_signing.key
</programlisting>
</para>

<para>
For Debian replace <i>codename</i> with Debian distribution
codename, and append the following to the end of the
<path>/etc/apt/sources.list</path> file:

<programlisting>
deb http://nginx.org/packages/debian/ <i>codename</i> nginx
deb-src http://nginx.org/packages/debian/ <i>codename</i> nginx
</programlisting>
</para>

<para>
Supported Debian versions:

<table note="yes">

<tr>
<td width="20%">Version</td>
<td>Codename</td>
</tr>

<tr>
<td width="20%">6.x</td>
<td>squeeze</td>
</tr>

</table>
</para>

<para>
For Ubuntu replace <i>codename</i> with Ubuntu distribution
codename, and append the following to the end of the
<path>/etc/apt/sources.list</path> file:

<programlisting>
deb http://nginx.org/packages/ubuntu/ <i>codename</i> nginx
deb-src http://nginx.org/packages/ubuntu/ <i>codename</i> nginx
</programlisting>
</para>

<para>
Supported Ubuntu versions:

<table note="yes">

<tr>
<td width="20%">Version</td>
<td>Codename</td>
</tr>

<tr>
<td width="20%">10.04</td>
<td>lucid</td>
</tr>

<tr>
<td width="20%">11.10</td>
<td>oneiric</td>
</tr>

<tr>
<td width="20%">12.04</td>
<td>precise</td>
</tr>

<tr>
<td width="20%">12.10</td>
<td>quantal</td>
</tr>

</table>
</para>

<para>
For Debian/Ubuntu then run the following commands:
<programlisting>
apt-get update
apt-get install nginx
</programlisting>
</para>

</section>

</article>