annotate xml/en/linux_packages.xml @ 2846:fdf1464e1977

Moved banner to the external file to make partial rollout possible. An idea is to have several banners and show them with different probability specified by split directive in the nginx.conf
author Sergey Budnevitch <sb@waeme.net>
date Tue, 10 May 2022 18:07:27 +0400
parents 55a573521ac3
children 8eda939a57e5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
1 <!--
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
2 Copyright (C) Nginx, Inc.
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
3 -->
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
4
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
5 <!DOCTYPE article SYSTEM "../../dtd/article.dtd">
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
6
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
7 <article name="nginx: Linux packages"
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
8 link="/en/linux_packages.html"
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
9 lang="en"
2841
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
10 rev="71">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
11
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
12 <section name="Supported distributions and versions" id="distributions">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
13
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
14 <para>
2325
409d024ac536 Emphasized that we provide Linux packages.
Konstantin Pavlov <thresh@videolan.org>
parents: 2324
diff changeset
15 nginx packages are available for the following Linux distributions and
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
16 versions:
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
17 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
18
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
19 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
20 <link id="RHEL-CentOS">RHEL/CentOS</link>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
21
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
22 <table note="yes">
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
23
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
24 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
25 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
26 <td>Supported Platforms</td>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
27 </tr>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
28
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
29 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
30 <td width="30%">7.4+</td>
2652
eb508d8c1c31 Linux packages: added RHEL/CentOS 7 aarch64/arm64.
Konstantin Pavlov <thresh@nginx.com>
parents: 2644
diff changeset
31 <td>x86_64, ppc64le, aarch64/arm64</td>
1252
27b22e625491 CentOS/RHEL 7 added to the package download page.
Sergey Budnevitch <sb@waeme.net>
parents: 1171
diff changeset
32 </tr>
27b22e625491 CentOS/RHEL 7 added to the package download page.
Sergey Budnevitch <sb@waeme.net>
parents: 1171
diff changeset
33
2380
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
34 <tr>
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
35 <td width="30%">8.x</td>
2813
b9c6c7ab035f Linux packages: Added CentOS/RHEL 8 and Ubuntu 20.04 s390x packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 2805
diff changeset
36 <td>x86_64, aarch64/arm64, s390x</td>
2380
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
37 </tr>
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
38
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
39 </table>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
40 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
41
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
42 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
43 <link id="Debian">Debian</link>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
44
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
45 <table note="yes">
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
46
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
47 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
48 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
49 <td>Supported Platforms</td>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
50 </tr>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
51
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
52 <tr>
2407
bd01d2a342b9 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2389
diff changeset
53 <td width="30%">10.x “buster”</td>
2619
94107f33b7bb Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2603
diff changeset
54 <td>x86_64, i386, aarch64/arm64</td>
2407
bd01d2a342b9 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2389
diff changeset
55 </tr>
bd01d2a342b9 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2389
diff changeset
56
2756
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
57 <tr>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
58 <td width="30%">11.x “bullseye”</td>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
59 <td>x86_64, aarch64/arm64</td>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
60 </tr>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
61
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
62 </table>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
63 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
64
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
65 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
66 <link id="Ubuntu">Ubuntu</link>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
67
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
68 <table note="yes">
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
69
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
70 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
71 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
72 <td>Supported Platforms</td>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
73 </tr>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
74
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
75 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
76 <td width="30%">18.04 “bionic”</td>
2279
7ec59c98d7d5 Actualized the list of supported Ubuntu versions and architectures.
Konstantin Pavlov <thresh@nginx.com>
parents: 2233
diff changeset
77 <td>x86_64, aarch64/arm64</td>
1921
ef3590465d67 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 1788
diff changeset
78 </tr>
ef3590465d67 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 1788
diff changeset
79
2160
a2e77354c77d Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2127
diff changeset
80 <tr>
2539
5a5a791b3166 Linux packages: added Ubuntu 20.04, removed 19.04.
Mikhail Isachenkov <mikhail.isachenkov@nginx.com>
parents: 2505
diff changeset
81 <td width="30%">20.04 “focal”</td>
2813
b9c6c7ab035f Linux packages: Added CentOS/RHEL 8 and Ubuntu 20.04 s390x packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 2805
diff changeset
82 <td>x86_64, aarch64/arm64, s390x</td>
2467
ee775a6ca22e Linux packages: added Ubuntu 19.10
Konstantin Pavlov <thresh@nginx.com>
parents: 2437
diff changeset
83 </tr>
ee775a6ca22e Linux packages: added Ubuntu 19.10
Konstantin Pavlov <thresh@nginx.com>
parents: 2437
diff changeset
84
2619
94107f33b7bb Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2603
diff changeset
85 <tr>
2786
6b3a80a735bf Linux packages: added Ubuntu 21.10 "impish".
Konstantin Pavlov <thresh@nginx.com>
parents: 2756
diff changeset
86 <td width="30%">21.10 “impish”</td>
6b3a80a735bf Linux packages: added Ubuntu 21.10 "impish".
Konstantin Pavlov <thresh@nginx.com>
parents: 2756
diff changeset
87 <td>x86_64, aarch64/arm64</td>
6b3a80a735bf Linux packages: added Ubuntu 21.10 "impish".
Konstantin Pavlov <thresh@nginx.com>
parents: 2756
diff changeset
88 </tr>
6b3a80a735bf Linux packages: added Ubuntu 21.10 "impish".
Konstantin Pavlov <thresh@nginx.com>
parents: 2756
diff changeset
89
2841
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
90 <tr>
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
91 <td width="30%">22.04 “jammy”</td>
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
92 <td>x86_64, aarch64/arm64</td>
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
93 </tr>
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
94
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
95 </table>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
96 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
97
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
98 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
99 <link id="SLES">SLES</link>
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
100
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
101 <table note="yes">
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
102
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
103 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
104 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
105 <td>Supported Platforms</td>
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
106 </tr>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
107
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
108 <tr>
2699
8b96520ca495 Linux packages: clarified supported SLES versions
Konstantin Pavlov <thresh@nginx.com>
parents: 2662
diff changeset
109 <td width="30%">12 SP5+</td>
1396
a886cc28d04d Supported platforms list for SLES fixed.
Sergey Budnevitch <sb@waeme.net>
parents: 1395
diff changeset
110 <td>x86_64</td>
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
111 </tr>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
112
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
113 <tr>
2699
8b96520ca495 Linux packages: clarified supported SLES versions
Konstantin Pavlov <thresh@nginx.com>
parents: 2662
diff changeset
114 <td width="30%">15 SP2+</td>
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
115 <td>x86_64</td>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
116 </tr>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
117
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
118 </table>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
119 </para>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
120
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
121 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
122 <link id="Alpine">Alpine</link>
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
123
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
124 <table note="yes">
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
125
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
126 <tr>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
127 <td width="30%">Version</td>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
128 <td>Supported platforms</td>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
129 </tr>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
130
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
131 <tr>
2568
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
132 <td width="30%">3.12</td>
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
133 <td>x86_64, aarch64/arm64</td>
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
134 </tr>
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
135
2644
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
136 <tr>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
137 <td width="30%">3.13</td>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
138 <td>x86_64, aarch64/arm64</td>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
139 </tr>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
140
2742
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
141 <tr>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
142 <td width="30%">3.14</td>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
143 <td>x86_64, aarch64/arm64</td>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
144 </tr>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
145
2805
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
146 <tr>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
147 <td width="30%">3.15</td>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
148 <td>x86_64, aarch64/arm64</td>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
149 </tr>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
150
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
151 </table>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
152 </para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
153
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
154 <para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
155 <link id="Amazon-Linux">Amazon Linux</link>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
156
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
157 <table note="yes">
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
158
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
159 <tr>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
160 <td width="30%">Version</td>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
161 <td>Supported platforms</td>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
162 </tr>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
163
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
164 <tr>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
165 <td width="30%">2 (LTS)</td>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
166 <td>x86_64, aarch64/arm64</td>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
167 </tr>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
168
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
169 </table>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
170 </para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
171
2326
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
172 </section>
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
173
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
174
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
175 <section name="Installation instructions" id="instructions">
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
176
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
177 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
178 Before you install nginx for the first time on a new machine, you need to
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
179 set up the nginx packages repository.
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
180 Afterward, you can install and update nginx from the repository.
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
181 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
182
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
183 <section name="RHEL/CentOS" id="RHEL-CentOS">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
184
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
185 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
186 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
187 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
188 sudo yum install yum-utils
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
189 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
190
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
191 To set up the yum repository, create the file named
1626
b6fad74f2aa1 Removed release packages from linux downloads page.
Konstantin Pavlov <thresh@nginx.com>
parents: 1598
diff changeset
192 <path>/etc/yum.repos.d/nginx.repo</path>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
193 with the following contents:
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
194
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
195 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
196 [nginx-stable]
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
197 name=nginx stable repo
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
198 baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
199 gpgcheck=1
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
200 enabled=1
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
201 gpgkey=https://nginx.org/keys/nginx_signing.key
2437
bf8eb55e35dd Linux packages: Added an instruction for yum/dnf to mark the repos as hotfixes.
Konstantin Pavlov <thresh@nginx.com>
parents: 2436
diff changeset
202 module_hotfixes=true
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
203
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
204 [nginx-mainline]
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
205 name=nginx mainline repo
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
206 baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
207 gpgcheck=1
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
208 enabled=0
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
209 gpgkey=https://nginx.org/keys/nginx_signing.key
2437
bf8eb55e35dd Linux packages: Added an instruction for yum/dnf to mark the repos as hotfixes.
Konstantin Pavlov <thresh@nginx.com>
parents: 2436
diff changeset
210 module_hotfixes=true
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
211 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
212
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
213 By default, the repository for stable nginx packages is used.
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
214 If you would like to use mainline nginx packages,
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
215 run the following command:
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
216 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
217 sudo yum-config-manager --enable nginx-mainline
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
218 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
219
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
220 To install nginx, run the following command:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
221 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
222 sudo yum install nginx
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
223 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
224
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
225 When prompted to accept the GPG key, verify that the fingerprint matches
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
226 <command>573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62</command>,
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
227 and if so, accept it.
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
228 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
229
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
230 </section>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
231
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
232
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
233 <section name="Debian" id="Debian">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
234
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
235 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
236 Install the prerequisites:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
237 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
238 sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
239 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
240 </para>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
241
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
242 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
243 Import an official nginx signing key so apt could verify the packages
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
244 authenticity.
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
245 Fetch the key:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
246 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
247 curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
248 | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
249 </programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
250
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
251 Verify that the downloaded file contains the proper key:
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
252 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
253 gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
254 </programlisting>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
255
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
256 The output should contain the full fingerprint
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
257 <command>573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62</command>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
258 as follows:
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
259 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
260 pub rsa2048 2011-08-19 [SC] [expires: 2024-06-14]
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
261 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
262 uid nginx signing key &lt;signing-key@nginx.com&gt;
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
263 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
264 If the fingerprint is different, remove the file.
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
265 </para>
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
266
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
267 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
268 To set up the apt repository for stable nginx packages,
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
269 run the following command:
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
270 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
271 echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
272 http://nginx.org/packages/debian `lsb_release -cs` nginx" \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
273 | sudo tee /etc/apt/sources.list.d/nginx.list
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
274 </programlisting>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
275
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
276 If you would like to use mainline nginx packages,
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
277 run the following command instead:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
278 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
279 echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
280 http://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
281 | sudo tee /etc/apt/sources.list.d/nginx.list
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
282 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
283 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
284
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
285 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
286 Set up repository pinning to prefer our packages over
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
287 distribution-provided ones:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
288 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
289 echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
290 | sudo tee /etc/apt/preferences.d/99nginx
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
291 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
292 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
293
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
294 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
295 To install nginx, run the following commands:
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
296 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
297 sudo apt update
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
298 sudo apt install nginx
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
299 </programlisting>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
300 </para>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
301
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
302 </section>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
303
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
304
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
305 <section name="Ubuntu" id="Ubuntu">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
306
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
307 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
308 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
309 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
310 sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
311 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
312 </para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
313
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
314 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
315 Import an official nginx signing key so apt could verify the packages
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
316 authenticity.
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
317 Fetch the key:
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
318 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
319 curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
320 | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
321 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
322
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
323 Verify that the downloaded file contains the proper key:
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
324 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
325 gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
326 </programlisting>
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
327
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
328 The output should contain the full fingerprint
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
329 <command>573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62</command>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
330 as follows:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
331 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
332 pub rsa2048 2011-08-19 [SC] [expires: 2024-06-14]
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
333 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
334 uid nginx signing key &lt;signing-key@nginx.com&gt;
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
335 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
336 If the fingerprint is different, remove the file.
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
337 </para>
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
338
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
339 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
340 To set up the apt repository for stable nginx packages,
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
341 run the following command:
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
342 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
343 echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
344 http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
345 | sudo tee /etc/apt/sources.list.d/nginx.list
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
346 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
347
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
348 If you would like to use mainline nginx packages,
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
349 run the following command instead:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
350 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
351 echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
352 http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
353 | sudo tee /etc/apt/sources.list.d/nginx.list
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
354 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
355 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
356
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
357 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
358 Set up repository pinning to prefer our packages over
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
359 distribution-provided ones:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
360 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
361 echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
362 | sudo tee /etc/apt/preferences.d/99nginx
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
363 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
364 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
365
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
366 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
367 To install nginx, run the following commands:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
368 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
369 sudo apt update
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
370 sudo apt install nginx
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
371 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
372 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
373
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
374 </section>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
375
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
376
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
377 <section name="SLES" id="SLES">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
378
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
379 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
380 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
381 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
382 sudo zypper install curl ca-certificates gpg2
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
383 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
384
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
385 To set up the zypper repository for stable nginx packages,
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
386 run the following command:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
387 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
388 sudo zypper addrepo --gpgcheck --type yum --refresh --check \
2635
bf8e98fe085f Linux packages: use $releasever_major in SLES repository instructions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2633
diff changeset
389 'http://nginx.org/packages/sles/$releasever_major' nginx-stable
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
390 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
391
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
392 If you would like to use mainline nginx packages,
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
393 run the following command instead:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
394 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
395 sudo zypper addrepo --gpgcheck --type yum --refresh --check \
2635
bf8e98fe085f Linux packages: use $releasever_major in SLES repository instructions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2633
diff changeset
396 'http://nginx.org/packages/mainline/sles/$releasever_major' nginx-mainline
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
397 </programlisting>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
398
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
399 Next, import an official nginx signing key so zypper/rpm could verify
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
400 the packages authenticity.
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
401 Fetch the key:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
402 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
403 curl -o /tmp/nginx_signing.key https://nginx.org/keys/nginx_signing.key
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
404 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
405
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
406 Verify that the downloaded file contains the proper key:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
407 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
408 gpg --with-fingerprint /tmp/nginx_signing.key
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
409 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
410
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
411 The output should contain the full fingerprint
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
412 <command>573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62</command>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
413 as follows:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
414 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
415 pub 2048R/7BD9BF62 2011-08-19 [expires: 2024-06-14]
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
416 Key fingerprint = 573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
417 uid nginx signing key &lt;signing-key@nginx.com&gt;
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
418 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
419
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
420 Finally, import the key to the rpm database:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
421 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
422 sudo rpmkeys --import /tmp/nginx_signing.key
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
423 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
424
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
425 To install nginx, run the following command:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
426 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
427 sudo zypper install nginx
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
428 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
429 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
430
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
431 </section>
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
432
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
433
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
434 <section name="Alpine" id="Alpine">
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
435
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
436 <para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
437 Install the prerequisites:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
438 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
439 sudo apk add openssl curl ca-certificates
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
440 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
441
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
442 To set up the apk repository for stable nginx packages,
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
443 run the following command:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
444 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
445 printf "%s%s%s%s\n" \
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
446 "@nginx " \
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
447 "http://nginx.org/packages/alpine/v" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
448 `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
449 "/main" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
450 | sudo tee -a /etc/apk/repositories
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
451 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
452
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
453 If you would like to use mainline nginx packages,
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
454 run the following command instead:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
455 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
456 printf "%s%s%s%s\n" \
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
457 "@nginx " \
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
458 "http://nginx.org/packages/mainline/alpine/v" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
459 `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
460 "/main" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
461 | sudo tee -a /etc/apk/repositories
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
462 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
463
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
464 Next, import an official nginx signing key so apk could verify
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
465 the packages authenticity.
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
466 Fetch the key:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
467 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
468 curl -o /tmp/nginx_signing.rsa.pub https://nginx.org/keys/nginx_signing.rsa.pub
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
469 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
470
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
471 Verify that downloaded file contains the proper key:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
472 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
473 openssl rsa -pubin -in /tmp/nginx_signing.rsa.pub -text -noout
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
474 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
475
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
476 The output should contain the following modulus:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
477 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
478 Public-Key: (2048 bit)
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
479 Modulus:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
480 00:fe:14:f6:0a:1a:b8:86:19:fe:cd:ab:02:9f:58:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
481 2f:37:70:15:74:d6:06:9b:81:55:90:99:96:cc:70:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
482 5c:de:5b:e8:4c:b2:0c:47:5b:a8:a2:98:3d:11:b1:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
483 f6:7d:a0:46:df:24:23:c6:d0:24:52:67:ba:69:ab:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
484 9a:4a:6a:66:2c:db:e1:09:f1:0d:b2:b0:e1:47:1f:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
485 0a:46:ac:0d:82:f3:3c:8d:02:ce:08:43:19:d9:64:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
486 86:c4:4e:07:12:c0:5b:43:ba:7d:17:8a:a3:f0:3d:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
487 98:32:b9:75:66:f4:f0:1b:2d:94:5b:7c:1c:e6:f3:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
488 04:7f:dd:25:b2:82:a6:41:04:b7:50:93:94:c4:7c:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
489 34:7e:12:7c:bf:33:54:55:47:8c:42:94:40:8e:34:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
490 5f:54:04:1d:9e:8c:57:48:d4:b0:f8:e4:03:db:3f:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
491 68:6c:37:fa:62:14:1c:94:d6:de:f2:2b:68:29:17:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
492 24:6d:f7:b5:b3:18:79:fd:31:5e:7f:4c:be:c0:99:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
493 13:cc:e2:97:2b:dc:96:9c:9a:d0:a7:c5:77:82:67:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
494 c9:cb:a9:e7:68:4a:e1:c5:ba:1c:32:0e:79:40:6e:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
495 ef:08:d7:a3:b9:5d:1a:df:ce:1a:c7:44:91:4c:d4:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
496 99:c8:88:69:b3:66:2e:b3:06:f1:f4:22:d7:f2:5f:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
497 ab:6d
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
498 Exponent: 65537 (0x10001)
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
499 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
500
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
501 Finally, move the key to apk trusted keys storage:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
502 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
503 sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
504 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
505
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
506 To install nginx, run the following command:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
507 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
508 sudo apk add nginx@nginx
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
509 </programlisting>
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
510
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
511 The <literal>@nginx</literal> tag should also be specified when installing
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
512 packages with <link url="#dynmodules">dynamic modules</link>:
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
513 <programlisting>
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
514 sudo apk add nginx-module-image-filter@nginx nginx-module-njs@nginx
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
515 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
516 </para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
517
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
518 </section>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
519
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
520
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
521 <section name="Amazon Linux" id="Amazon-Linux">
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
522
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
523 <para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
524 Install the prerequisites:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
525 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
526 sudo yum install yum-utils
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
527 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
528
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
529 To set up the yum repository, create the file named
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
530 <path>/etc/yum.repos.d/nginx.repo</path>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
531 with the following contents:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
532
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
533 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
534 [nginx-stable]
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
535 name=nginx stable repo
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
536 baseurl=http://nginx.org/packages/amzn2/$releasever/$basearch/
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
537 gpgcheck=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
538 enabled=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
539 gpgkey=https://nginx.org/keys/nginx_signing.key
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
540 module_hotfixes=true
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
541
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
542 [nginx-mainline]
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
543 name=nginx mainline repo
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
544 baseurl=http://nginx.org/packages/mainline/amzn2/$releasever/$basearch/
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
545 gpgcheck=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
546 enabled=0
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
547 gpgkey=https://nginx.org/keys/nginx_signing.key
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
548 module_hotfixes=true
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
549 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
550
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
551 By default, the repository for stable nginx packages is used.
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
552 If you would like to use mainline nginx packages,
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
553 run the following command:
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
554 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
555 sudo yum-config-manager --enable nginx-mainline
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
556 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
557
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
558 To install nginx, run the following command:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
559 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
560 sudo yum install nginx
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
561 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
562
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
563 When prompted to accept the GPG key, verify that the fingerprint matches
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
564 <command>573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62</command>,
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
565 and if so, accept it.
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
566 </para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
567
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
568 </section>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
569
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
570 </section>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
571
932
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
572
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
573 <section name="Source Packages" id="sourcepackages">
1482
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
574
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
575 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
576 Packaging sources can be found in the
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
577 <link url="http://hg.nginx.org/pkg-oss">packaging sources repository</link>.
1482
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
578 </para>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
579
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
580 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
581 The <literal>default</literal> branch holds packaging sources for the current
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
582 mainline version, while <literal>stable-*</literal> branches contain latest
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
583 sources for stable releases.
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
584 To build binary packages, run <command>make</command> in
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
585 <path>debian/</path> directory on Debian/Ubuntu, or in
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
586 <path>rpm/SPECS/</path> on RHEL/CentOS/SLES/Amazon Linux, or in
2625
987768ee3211 Linux packages: fixed path for Alpine package sources.
Konstantin Pavlov <thresh@nginx.com>
parents: 2619
diff changeset
587 <path>alpine/</path> on Alpine.
1788
e739f2281571 Mentioned --with-stream_realip_module configure argument for mainline packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 1787
diff changeset
588 </para>
e739f2281571 Mentioned --with-stream_realip_module configure argument for mainline packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 1787
diff changeset
589
e739f2281571 Mentioned --with-stream_realip_module configure argument for mainline packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 1787
diff changeset
590 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
591 Packaging sources are distributed under the same
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
592 <link url="../LICENSE">2-clause BSD-like license</link>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
593 used by nginx.
1482
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
594 </para>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
595
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
596 </section>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
597
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
598
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
599 <section name="Dynamic Modules" id="dynmodules">
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
600
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
601 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
602 Main nginx package is built with all modules that do not require additional
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
603 libraries to avoid extra dependencies.
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
604 Since version 1.9.11, nginx supports
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
605 <link doc="docs/ngx_core_module.xml" id="load_module">dynamic modules</link>
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
606 and the following modules are built as dynamic and shipped as separate
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
607 packages:
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
608 <programlisting>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
609 nginx-module-geoip
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
610 nginx-module-image-filter
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
611 nginx-module-njs
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
612 nginx-module-perl
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
613 nginx-module-xslt
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
614 </programlisting>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
615 </para>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
616
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
617 </section>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
618
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
619
932
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
620 <section name="Signatures" id="signatures">
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
621
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
622 <para>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
623 Since our <link doc="../en/pgp_keys.xml">PGP keys</link>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
624 and packages are located on the same server,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
625 they are equally trusted.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
626 It is highly advised to additionally verify
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
627 the authenticity of the downloaded PGP key.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
628 PGP has the “Web of Trust” concept,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
629 when a key is signed by someone else’s key,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
630 that in turn is signed by another key and so on.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
631 It often makes possible to build a chain from an arbitrary key
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
632 to someone’s key who you know and trust personally,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
633 thus verify the authenticity of the first key in a chain.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
634 This concept is described in details in
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
635 <link url="http://www.dewinter.com/gnupg_howto/english/GPGMiniHowto-1.html">
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
636 GPG Mini Howto</link>.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
637 Our keys have enough signatures,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
638 and their authenticity is relatively easy to check.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
639 </para>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
640
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
641 </section>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
642
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
643 </article>