annotate xml/en/linux_packages.xml @ 2913:a20b51e84c32

Linux packages: actualized supported Alpine Linux versions.
author Konstantin Pavlov <thresh@nginx.com>
date Fri, 25 Nov 2022 11:13:56 +0400
parents 4eb241b57f83
children 23d3cabaab95
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"
2913
a20b51e84c32 Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2906
diff changeset
10 rev="82">
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>
2893
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
20 <link id="RHEL">RHEL and derivatives</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>
2860
40d40af45ac8 Linux packages: updated the supported architectures for RHEL.
Konstantin Pavlov <thresh@nginx.com>
parents: 2856
diff changeset
31 <td>x86_64, 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
2849
8eda939a57e5 Linux packages: added RHEL 9.
Konstantin Pavlov <thresh@nginx.com>
parents: 2841
diff changeset
39 <tr>
8eda939a57e5 Linux packages: added RHEL 9.
Konstantin Pavlov <thresh@nginx.com>
parents: 2841
diff changeset
40 <td width="30%">9.x</td>
2860
40d40af45ac8 Linux packages: updated the supported architectures for RHEL.
Konstantin Pavlov <thresh@nginx.com>
parents: 2856
diff changeset
41 <td>x86_64, aarch64/arm64, s390x</td>
2849
8eda939a57e5 Linux packages: added RHEL 9.
Konstantin Pavlov <thresh@nginx.com>
parents: 2841
diff changeset
42 </tr>
8eda939a57e5 Linux packages: added RHEL 9.
Konstantin Pavlov <thresh@nginx.com>
parents: 2841
diff changeset
43
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
44 </table>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
45 </para>
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 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
48 <link id="Debian">Debian</link>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
49
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
50 <table note="yes">
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>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
53 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
54 <td>Supported Platforms</td>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
55 </tr>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
56
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
57 <tr>
2756
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>
2841
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
86 <td width="30%">22.04 “jammy”</td>
2864
b2e6057d99af Linux packages: updated the supported architectures for Ubuntu 22.04.
Konstantin Pavlov <thresh@nginx.com>
parents: 2860
diff changeset
87 <td>x86_64, aarch64/arm64, s390x</td>
2841
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
88 </tr>
55a573521ac3 Linux packages: added Ubuntu 22.04 "jammy".
Konstantin Pavlov <thresh@nginx.com>
parents: 2828
diff changeset
89
2906
4eb241b57f83 Linux packages: added Ubuntu 22.10 "kinetic".
Konstantin Pavlov <thresh@nginx.com>
parents: 2896
diff changeset
90 <tr>
4eb241b57f83 Linux packages: added Ubuntu 22.10 "kinetic".
Konstantin Pavlov <thresh@nginx.com>
parents: 2896
diff changeset
91 <td width="30%">22.10 “kinetic”</td>
4eb241b57f83 Linux packages: added Ubuntu 22.10 "kinetic".
Konstantin Pavlov <thresh@nginx.com>
parents: 2896
diff changeset
92 <td>x86_64, aarch64/arm64</td>
4eb241b57f83 Linux packages: added Ubuntu 22.10 "kinetic".
Konstantin Pavlov <thresh@nginx.com>
parents: 2896
diff changeset
93 </tr>
4eb241b57f83 Linux packages: added Ubuntu 22.10 "kinetic".
Konstantin Pavlov <thresh@nginx.com>
parents: 2896
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>
2742
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
132 <td width="30%">3.14</td>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
133 <td>x86_64, aarch64/arm64</td>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
134 </tr>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
135
2805
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
136 <tr>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
137 <td width="30%">3.15</td>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
138 <td>x86_64, aarch64/arm64</td>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
139 </tr>
6fa0e92f6607 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2786
diff changeset
140
2856
d9f5ff496aad Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2853
diff changeset
141 <tr>
d9f5ff496aad Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2853
diff changeset
142 <td width="30%">3.16</td>
d9f5ff496aad Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2853
diff changeset
143 <td>x86_64, aarch64/arm64</td>
d9f5ff496aad Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2853
diff changeset
144 </tr>
d9f5ff496aad Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2853
diff changeset
145
2913
a20b51e84c32 Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2906
diff changeset
146 <tr>
a20b51e84c32 Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2906
diff changeset
147 <td width="30%">3.17</td>
a20b51e84c32 Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2906
diff changeset
148 <td>x86_64, aarch64/arm64</td>
a20b51e84c32 Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2906
diff changeset
149 </tr>
a20b51e84c32 Linux packages: actualized supported Alpine Linux versions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2906
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
2893
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
183 <section name="RHEL and derivatives" id="RHEL">
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
184
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
185 <para>
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
186 This section applies to Red Hat Enterprise Linux and its derivatives such as
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
187 CentOS, Oracle Linux, Rocky Linux, AlmaLinux.
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
188 </para>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
189
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
190 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
191 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
192 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
193 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
194 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
195
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
196 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
197 <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
198 with the following contents:
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
199
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
200 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
201 [nginx-stable]
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
202 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
203 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
204 gpgcheck=1
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
205 enabled=1
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
206 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
207 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
208
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
209 [nginx-mainline]
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
210 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
211 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
212 gpgcheck=1
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
213 enabled=0
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
214 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
215 module_hotfixes=true
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
216 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
217
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
218 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
219 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
220 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
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-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
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 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
226 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
227 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
228 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
229
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
230 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
231 <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
232 and if so, accept it.
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
233 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
234
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
235 </section>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
236
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
237
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
238 <section name="Debian" id="Debian">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
239
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
240 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
241 Install the prerequisites:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
242 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
243 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
244 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
245 </para>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
246
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
247 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
248 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
249 authenticity.
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
250 Fetch the key:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
251 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
252 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
253 | 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
254 </programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
255
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
256 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
257 <programlisting>
2896
6bc630596c06 Linux packages: key verification command adjusted.
Andrei Belov <defan@nginx.com>
parents: 2893
diff changeset
258 gpg --dry-run --quiet --no-keyring --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
259 </programlisting>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
260
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
261 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
262 <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
263 as follows:
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
264 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
265 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
266 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
267 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
268 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
269 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
270 </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
271
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
272 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
273 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
274 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
275 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
276 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
277 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
278 | 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
279 </programlisting>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
280
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
281 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
282 run the following command instead:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
283 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
284 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
285 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
286 | 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
287 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
288 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
289
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
290 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
291 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
292 distribution-provided ones:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
293 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
294 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
295 | 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
296 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
297 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
298
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
299 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
300 To install nginx, run the following commands:
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
301 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
302 sudo apt update
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
303 sudo apt install nginx
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
304 </programlisting>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
305 </para>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
306
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
307 </section>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
308
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
309
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
310 <section name="Ubuntu" id="Ubuntu">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
311
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
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 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
314 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
315 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
316 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
317 </para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
318
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
319 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
320 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
321 authenticity.
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
322 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
323 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
324 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
325 | 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
326 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
327
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
328 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
329 <programlisting>
2896
6bc630596c06 Linux packages: key verification command adjusted.
Andrei Belov <defan@nginx.com>
parents: 2893
diff changeset
330 gpg --dry-run --quiet --no-keyring --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
331 </programlisting>
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
332
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
333 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
334 <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
335 as follows:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
336 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
337 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
338 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
339 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
340 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
341 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
342 </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
343
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
344 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
345 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
346 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
347 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
348 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
349 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
350 | 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
351 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
352
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
353 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
354 run the following command instead:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
355 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
356 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
357 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
358 | 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
359 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
360 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
361
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
362 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
363 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
364 distribution-provided ones:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
365 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
366 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
367 | 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
368 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
369 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
370
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
371 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
372 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
373 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
374 sudo apt update
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
375 sudo apt install nginx
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
376 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
377 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
378
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
379 </section>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
380
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
381
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
382 <section name="SLES" id="SLES">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
383
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
384 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
385 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
386 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
387 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
388 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
389
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
390 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
391 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
392 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
393 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
394 '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
395 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
396
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
397 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
398 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
399 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
400 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
401 '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
402 </programlisting>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
403
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
404 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
405 the packages authenticity.
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
406 Fetch the key:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
407 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
408 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
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 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
412 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
413 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
414 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
415
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
416 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
417 <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
418 as follows:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
419 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
420 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
421 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
422 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
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 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
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 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
428 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
429
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
430 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
431 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
432 sudo zypper install nginx
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
433 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
434 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
435
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
436 </section>
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
437
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
438
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
439 <section name="Alpine" id="Alpine">
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
440
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
441 <para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
442 Install the prerequisites:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
443 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
444 sudo apk add openssl curl ca-certificates
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
445 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
446
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
447 To set up the apk repository for stable nginx packages,
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
448 run the following command:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
449 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
450 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
451 "@nginx " \
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
452 "http://nginx.org/packages/alpine/v" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
453 `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
454 "/main" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
455 | sudo tee -a /etc/apk/repositories
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
456 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
457
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
458 If you would like to use mainline nginx packages,
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
459 run the following command instead:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
460 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
461 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
462 "@nginx " \
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
463 "http://nginx.org/packages/mainline/alpine/v" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
464 `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
465 "/main" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
466 | sudo tee -a /etc/apk/repositories
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
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
469 Next, import an official nginx signing key so apk could verify
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
470 the packages authenticity.
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
471 Fetch the 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 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
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 Verify that downloaded file contains the proper key:
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 openssl rsa -pubin -in /tmp/nginx_signing.rsa.pub -text -noout
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
479 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
480
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
481 The output should contain the following modulus:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
482 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
483 Public-Key: (2048 bit)
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
484 Modulus:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
485 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
486 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
487 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
488 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
489 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
490 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
491 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
492 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
493 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
494 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
495 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
496 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
497 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
498 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
499 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
500 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
501 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
502 ab:6d
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
503 Exponent: 65537 (0x10001)
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 Finally, move the key to apk trusted keys storage:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
507 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
508 sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
509 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
510
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
511 To install nginx, run the following command:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
512 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
513 sudo apk add nginx@nginx
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
514 </programlisting>
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
515
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
516 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
517 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
518 <programlisting>
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
519 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
520 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
521 </para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
522
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
523 </section>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
524
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
525
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
526 <section name="Amazon Linux" id="Amazon-Linux">
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
527
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
528 <para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
529 Install the prerequisites:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
530 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
531 sudo yum install yum-utils
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
532 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
533
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
534 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
535 <path>/etc/yum.repos.d/nginx.repo</path>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
536 with the following contents:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
537
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
538 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
539 [nginx-stable]
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
540 name=nginx stable repo
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
541 baseurl=http://nginx.org/packages/amzn2/$releasever/$basearch/
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
542 gpgcheck=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
543 enabled=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
544 gpgkey=https://nginx.org/keys/nginx_signing.key
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
545 module_hotfixes=true
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
546
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
547 [nginx-mainline]
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
548 name=nginx mainline repo
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
549 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
550 gpgcheck=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
551 enabled=0
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
552 gpgkey=https://nginx.org/keys/nginx_signing.key
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
553 module_hotfixes=true
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
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
556 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
557 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
558 run the following command:
2730
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-config-manager --enable nginx-mainline
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 To install nginx, run the following command:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
564 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
565 sudo yum install nginx
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
566 </programlisting>
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 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
569 <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
570 and if so, accept it.
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
571 </para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
572
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
573 </section>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
574
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
575 </section>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
576
932
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
577
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
578 <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
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 Packaging sources can be found in the
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
582 <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
583 </para>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
584
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
585 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
586 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
587 mainline version, while <literal>stable-*</literal> branches contain latest
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
588 sources for stable releases.
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
589 To build binary packages, run <command>make</command> in
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
590 <path>debian/</path> directory on Debian/Ubuntu, or in
2893
8f3955097546 Linux packages: reword to mention supported RHEL derivatives.
Konstantin Pavlov <thresh@nginx.com>
parents: 2891
diff changeset
591 <path>rpm/SPECS/</path> on RHEL and derivatives, SLES, and Amazon Linux, or in
2625
987768ee3211 Linux packages: fixed path for Alpine package sources.
Konstantin Pavlov <thresh@nginx.com>
parents: 2619
diff changeset
592 <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
593 </para>
e739f2281571 Mentioned --with-stream_realip_module configure argument for mainline packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 1787
diff changeset
594
e739f2281571 Mentioned --with-stream_realip_module configure argument for mainline packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 1787
diff changeset
595 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
596 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
597 <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
598 used by nginx.
1482
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
599 </para>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
600
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
601 </section>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
602
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
603
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
604 <section name="Dynamic Modules" id="dynmodules">
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
605
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
606 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
607 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
608 libraries to avoid extra dependencies.
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
609 Since version 1.9.11, nginx supports
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
610 <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
611 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
612 packages:
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
613 <programlisting>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
614 nginx-module-geoip
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
615 nginx-module-image-filter
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
616 nginx-module-njs
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
617 nginx-module-perl
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
618 nginx-module-xslt
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
619 </programlisting>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
620 </para>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
621
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
622 </section>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
623
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
624
932
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
625 <section name="Signatures" id="signatures">
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
626
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
627 <para>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
628 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
629 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
630 they are equally trusted.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
631 It is highly advised to additionally verify
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
632 the authenticity of the downloaded PGP key.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
633 PGP has the “Web of Trust” concept,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
634 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
635 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
636 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
637 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
638 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
639 This concept is described in details in
2853
74cb8ff74831 Linux packages: fixed GPG Mini Howto link.
Konstantin Pavlov <thresh@nginx.com>
parents: 2849
diff changeset
640 <link url="https://www.gnupg.org/howtos/en/GPGMiniHowto-1.html">
932
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
641 GPG Mini Howto</link>.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
642 Our keys have enough signatures,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
643 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
644 </para>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
645
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
646 </section>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
647
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
648 </article>