annotate xml/en/linux_packages.xml @ 2841:55a573521ac3

Linux packages: added Ubuntu 22.04 "jammy".
author Konstantin Pavlov <thresh@nginx.com>
date Fri, 29 Apr 2022 21:36:07 +0400
parents 86cd1a0c708f
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>