Mercurial > hg > nginx-site

comparison xml/en/linux_packages.xml @ 882:d1002c39ac0a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Linux packages related information moved to separate page. Documentation about packages for mainline version added.
author Sergey Budnevitch <sb@waeme.net>
date Tue, 02 Apr 2013 20:53:03 +0400
parents
children 893d36b6d013
comparison
equal deleted inserted replaced
881:d7f2325fa832 882:d1002c39ac0a
1 <!--
2 Copyright (C) Nginx, Inc.
3 -->
4
5 <!DOCTYPE article SYSTEM "../../dtd/article.dtd">
6
7 <article name="nginx: Linux packages"
8 link="/en/linux_packages.html"
9 lang="en"
10 rev="1"
11 toc="no">
12
13 <section id="distributions">
14
15 <para>
16 Currently, nginx packages are available for the following distributions and
17 versions:
18 </para>
19
20 <para>
21 RHEL/CentOS:
22
23 <table note="yes">
24
25 <tr>
26 <td width="20%">Version</td>
27 </tr>
28
29 <tr>
30 <td width="20%">5.x</td>
31 </tr>
32
33 <tr>
34 <td width="20%">6.x</td>
35 </tr>
36
37 </table>
38 </para>
39
40 <para>
41 Debian:
42
43 <table note="yes">
44
45 <tr>
46 <td width="20%">Version</td>
47 <td>Codename</td>
48 </tr>
49
50 <tr>
51 <td width="20%">6.x</td>
52 <td>squeeze</td>
53 </tr>
54
55 </table>
56 </para>
57
58 <para>
59 Ubuntu:
60
61 <table note="yes">
62
63 <tr>
64 <td width="20%">Version</td>
65 <td>Codename</td>
66 </tr>
67
68 <tr>
69 <td width="20%">10.04</td>
70 <td>lucid</td>
71 </tr>
72
73 <tr>
74 <td width="20%">11.10</td>
75 <td>oneiric</td>
76 </tr>
77
78 <tr>
79 <td width="20%">12.04</td>
80 <td>precise</td>
81 </tr>
82
83 <tr>
84 <td width="20%">12.10</td>
85 <td>quantal</td>
86 </tr>
87
88 </table>
89 </para>
90
91 <para>
92 To enable automatic updates of Linux packages
93 set up the yum repository for the RHEL/CentOS distributions,
94 or the apt repository for the Debian/Ubuntu distributions.
95 </para>
96
97 </section>
98
99
100 <section name="Pre-Built Packages for Stable version" id="stable">
101
102 <para>
103 To set up the yum repository for RHEL/CentOS, choose the corresponding
104 <literal>nginx-release</literal> package from the list:
105
106 <list type="bullet">
107
108 <listitem>
109 <link url="http://nginx.org/packages/rhel/5/noarch/RPMS/nginx-release-rhel-5-0.el5.ngx.noarch.rpm">RHEL 5</link>
110 </listitem>
111
112 <listitem>
113 <link url="http://nginx.org/packages/rhel/6/noarch/RPMS/nginx-release-rhel-6-0.el6.ngx.noarch.rpm">RHEL 6</link>
114 </listitem>
115
116 <listitem>
117 <link url="http://nginx.org/packages/centos/5/noarch/RPMS/nginx-release-centos-5-0.el5.ngx.noarch.rpm">CentOS 5</link>
118 </listitem>
119
120 <listitem>
121 <link url="http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm">CentOS 6</link>
122 </listitem>
123
124 </list>
125
126 This package contains yum configuration file
127 and a public PGP key necessary to authenticate signed RPMs.
128 Download and install it, then run the following:
129 <programlisting>
130 yum install nginx
131 </programlisting>
132
133 Alternatively, a repository configuration can be added manually
134 without installing the <literal>nginx-release</literal> package.
135 Create the file named <path>/etc/yum.repos.d/nginx.repo</path>
136 with the following contents:
137
138 <programlisting>
139 [nginx]
140 name=nginx repo
141 baseurl=http://nginx.org/packages/OS/OSRELEASE/$basearch/
142 gpgcheck=0
143 enabled=1
144 </programlisting>
145
146 Replace “<literal>OS</literal>” with “<literal>rhel</literal>” or
147 “<literal>centos</literal>”,
148 depending on the distribution used, and “<literal>OSRELEASE</literal>”
149 with “<literal>5</literal>” or “<literal>6</literal>”,
150 for 5.x or 6.x versions, respectively.
151 </para>
152
153 <para>
154 For Debian/Ubuntu, in order to authenticate the nginx repository signature
155 and to eliminate warnings about missing gpg key during installation of the
156 nginx package, it is necessary to add the key used to sign the nginx
157 packages and repository to the <command>apt</command> program keyring.
158 Please download <link url="http://nginx.org/keys/nginx_signing.key">this
159 key</link> from our web site, and add it to the <command>apt</command>
160 program keyring with the following command:
161 <programlisting>
162 sudo apt-key add nginx_signing.key
163 </programlisting>
164 </para>
165
166 <para>
167 For Debian replace <i>codename</i> with Debian distribution
168 <link id="distributions">codename</link>, and append the following to
169 the end of the <path>/etc/apt/sources.list</path> file:
170
171 <programlisting>
172 deb http://nginx.org/packages/debian/ <i>codename</i> nginx
173 deb-src http://nginx.org/packages/debian/ <i>codename</i> nginx
174 </programlisting>
175 </para>
176
177 <para>
178 For Ubuntu replace <i>codename</i> with Ubuntu distribution
179 <link id="distributions">codename</link>, and append the following to
180 the end of the <path>/etc/apt/sources.list</path> file:
181
182 <programlisting>
183 deb http://nginx.org/packages/ubuntu/ <i>codename</i> nginx
184 deb-src http://nginx.org/packages/ubuntu/ <i>codename</i> nginx
185 </programlisting>
186 </para>
187
188 <para>
189 For Debian/Ubuntu then run the following commands:
190 <programlisting>
191 apt-get update
192 apt-get install nginx
193 </programlisting>
194 </para>
195
196 </section>
197
198
199 <section name="Pre-Built Packages for Mainline version" id="mainline">
200
201 <para>
202 To set up the yum repository for RHEL/CentOS, create the file named
203 <path>/etc/yum.repos.d/nginx.repo</path>
204 with the following contents:
205
206 <programlisting>
207 [nginx]
208 name=nginx repo
209 baseurl=http://nginx.org/packages/mainline/OS/OSRELEASE/$basearch/
210 gpgcheck=0
211 enabled=1
212 </programlisting>
213
214 Replace “<literal>OS</literal>” with “<literal>rhel</literal>” or
215 “<literal>centos</literal>”,
216 depending on the distribution used, and “<literal>OSRELEASE</literal>”
217 with “<literal>5</literal>” or “<literal>6</literal>”,
218 for 5.x or 6.x versions, respectively.
219 </para>
220
221 <para>
222 For Debian/Ubuntu, in order to authenticate the nginx repository signature
223 and to eliminate warnings about missing gpg key during installation of the
224 nginx package, it is necessary to add the key used to sign the nginx
225 packages and repository to the <command>apt</command> program keyring.
226 Please download <link url="http://nginx.org/keys/nginx_signing.key">this
227 key</link> from our web site, and add it to the <command>apt</command>
228 program keyring with the following command:
229 <programlisting>
230 sudo apt-key add nginx_signing.key
231 </programlisting>
232 </para>
233
234 <para>
235 For Debian replace <i>codename</i> with Debian distribution
236 <link id="distributions">codename</link>, and append the following to
237 the end of the <path>/etc/apt/sources.list</path> file:
238
239 <programlisting>
240 deb http://nginx.org/packages/mainline/debian/ <i>codename</i> nginx
241 deb-src http://nginx.org/packages/mainline/debian/ <i>codename</i> nginx
242 </programlisting>
243 </para>
244
245 <para>
246 For Ubuntu replace <i>codename</i> with Ubuntu distribution
247 <link id="distributions">codename</link>, and append the following to
248 the end of the <path>/etc/apt/sources.list</path> file:
249
250 <programlisting>
251 deb http://nginx.org/packages/mainline/ubuntu/ <i>codename</i> nginx
252 deb-src http://nginx.org/packages/mainline/ubuntu/ <i>codename</i> nginx
253 </programlisting>
254 </para>
255
256 <para>
257 For Debian/Ubuntu then run the following commands:
258 <programlisting>
259 apt-get update
260 apt-get install nginx
261 </programlisting>
262 </para>
263
264 </section>
265
266 </article>