Mercurial > hg > nginx-site

annotate xml/en/linux_packages.xml @ 2756:7898e090ad72

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Linux packages: added Debian 11 "Bullseye".
author Konstantin Pavlov <thresh@nginx.com>
date Tue, 17 Aug 2021 12:33:41 +0300
parents 6eff5d63925b
children 6b3a80a735bf
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"
2756
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
10 rev="66">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
11
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
12 <section name="Supported distributions and versions" id="distributions">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
13
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
14 <para>
2325
409d024ac536 Emphasized that we provide Linux packages.
Konstantin Pavlov <thresh@videolan.org>
parents: 2324
diff changeset
15 nginx packages are available for the following Linux distributions and
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
16 versions:
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
17 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
18
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
19 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
20 <link id="RHEL-CentOS">RHEL/CentOS</link>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
21
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
22 <table note="yes">
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
23
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
24 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
25 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
26 <td>Supported Platforms</td>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
27 </tr>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
28
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
29 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
30 <td width="30%">7.4+</td>
2652
eb508d8c1c31 Linux packages: added RHEL/CentOS 7 aarch64/arm64.
Konstantin Pavlov <thresh@nginx.com>
parents: 2644
diff changeset
31 <td>x86_64, ppc64le, aarch64/arm64</td>
1252
27b22e625491 CentOS/RHEL 7 added to the package download page.
Sergey Budnevitch <sb@waeme.net>
parents: 1171
diff changeset
32 </tr>
27b22e625491 CentOS/RHEL 7 added to the package download page.
Sergey Budnevitch <sb@waeme.net>
parents: 1171
diff changeset
33
2380
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
34 <tr>
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
35 <td width="30%">8.x</td>
2568
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
36 <td>x86_64, aarch64/arm64</td>
2380
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
37 </tr>
f0aeaa03cb6a Linux packages: added RHEL 8.
Konstantin Pavlov <thresh@nginx.com>
parents: 2375
diff changeset
38
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
39 </table>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
40 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
41
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
42 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
43 <link id="Debian">Debian</link>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
44
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
45 <table note="yes">
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
46
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
47 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
48 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
49 <td>Supported Platforms</td>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
50 </tr>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
51
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
52 <tr>
2407
bd01d2a342b9 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2389
diff changeset
53 <td width="30%">10.x “buster”</td>
2619
94107f33b7bb Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2603
diff changeset
54 <td>x86_64, i386, aarch64/arm64</td>
2407
bd01d2a342b9 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2389
diff changeset
55 </tr>
bd01d2a342b9 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2389
diff changeset
56
2756
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
57 <tr>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
58 <td width="30%">11.x “bullseye”</td>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
59 <td>x86_64, aarch64/arm64</td>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
60 </tr>
7898e090ad72 Linux packages: added Debian 11 "Bullseye".
Konstantin Pavlov <thresh@nginx.com>
parents: 2755
diff changeset
61
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
62 </table>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
63 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
64
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
65 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
66 <link id="Ubuntu">Ubuntu</link>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
67
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
68 <table note="yes">
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
69
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
70 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
71 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
72 <td>Supported Platforms</td>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
73 </tr>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
74
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
75 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
76 <td width="30%">18.04 “bionic”</td>
2279
7ec59c98d7d5 Actualized the list of supported Ubuntu versions and architectures.
Konstantin Pavlov <thresh@nginx.com>
parents: 2233
diff changeset
77 <td>x86_64, aarch64/arm64</td>
1921
ef3590465d67 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 1788
diff changeset
78 </tr>
ef3590465d67 Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 1788
diff changeset
79
2160
a2e77354c77d Linux packages: updated the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2127
diff changeset
80 <tr>
2539
5a5a791b3166 Linux packages: added Ubuntu 20.04, removed 19.04.
Mikhail Isachenkov <mikhail.isachenkov@nginx.com>
parents: 2505
diff changeset
81 <td width="30%">20.04 “focal”</td>
5a5a791b3166 Linux packages: added Ubuntu 20.04, removed 19.04.
Mikhail Isachenkov <mikhail.isachenkov@nginx.com>
parents: 2505
diff changeset
82 <td>x86_64, aarch64/arm64</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>
2731
5d15140ad319 Linux packages: added Ubuntu 21.04 'hirsute'.
Konstantin Pavlov <thresh@nginx.com>
parents: 2730
diff changeset
86 <td width="30%">21.04 “hirsute”</td>
5d15140ad319 Linux packages: added Ubuntu 21.04 'hirsute'.
Konstantin Pavlov <thresh@nginx.com>
parents: 2730
diff changeset
87 <td>x86_64, aarch64/arm64</td>
5d15140ad319 Linux packages: added Ubuntu 21.04 'hirsute'.
Konstantin Pavlov <thresh@nginx.com>
parents: 2730
diff changeset
88 </tr>
5d15140ad319 Linux packages: added Ubuntu 21.04 'hirsute'.
Konstantin Pavlov <thresh@nginx.com>
parents: 2730
diff changeset
89
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
90 </table>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
91 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
92
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
93 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
94 <link id="SLES">SLES</link>
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
95
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
96 <table note="yes">
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
97
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
98 <tr>
2321
580c3007d242 Merged version and codename.
Konstantin Pavlov <thresh@videolan.org>
parents: 2279
diff changeset
99 <td width="30%">Version</td>
1395
d68d1b88512a List of supported platforms for linux packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1368
diff changeset
100 <td>Supported Platforms</td>
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
101 </tr>
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>
2699
8b96520ca495 Linux packages: clarified supported SLES versions
Konstantin Pavlov <thresh@nginx.com>
parents: 2662
diff changeset
104 <td width="30%">12 SP5+</td>
1396
a886cc28d04d Supported platforms list for SLES fixed.
Sergey Budnevitch <sb@waeme.net>
parents: 1395
diff changeset
105 <td>x86_64</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
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
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%">15 SP2+</td>
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
110 <td>x86_64</td>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
111 </tr>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
112
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
113 </table>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
114 </para>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
115
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
116 <para>
2324
3cf6a0cbec12 Added intra-page anchors and table of contents.
Konstantin Pavlov <thresh@videolan.org>
parents: 2323
diff changeset
117 <link id="Alpine">Alpine</link>
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
118
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
119 <table note="yes">
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
120
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
121 <tr>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
122 <td width="30%">Version</td>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
123 <td>Supported platforms</td>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
124 </tr>
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>
2505
ae52ac67048c Linux packages: Added Alpine 3.11.
Konstantin Pavlov <thresh@nginx.com>
parents: 2467
diff changeset
127 <td width="30%">3.11</td>
ae52ac67048c Linux packages: Added Alpine 3.11.
Konstantin Pavlov <thresh@nginx.com>
parents: 2467
diff changeset
128 <td>x86_64</td>
ae52ac67048c Linux packages: Added Alpine 3.11.
Konstantin Pavlov <thresh@nginx.com>
parents: 2467
diff changeset
129 </tr>
ae52ac67048c Linux packages: Added Alpine 3.11.
Konstantin Pavlov <thresh@nginx.com>
parents: 2467
diff changeset
130
2568
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
131 <tr>
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
132 <td width="30%">3.12</td>
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
133 <td>x86_64, aarch64/arm64</td>
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
134 </tr>
aa015272ea32 Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2539
diff changeset
135
2644
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
136 <tr>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
137 <td width="30%">3.13</td>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
138 <td>x86_64, aarch64/arm64</td>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
139 </tr>
b1aab2fa2b8f Linux packages: actualized the list of supported distributions.
Konstantin Pavlov <thresh@nginx.com>
parents: 2635
diff changeset
140
2742
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
141 <tr>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
142 <td width="30%">3.14</td>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
143 <td>x86_64, aarch64/arm64</td>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
144 </tr>
0a37493dda21 Linux packages: added Alpine 3.14.
Konstantin Pavlov <thresh@nginx.com>
parents: 2733
diff changeset
145
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
146 </table>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
147 </para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
148
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
149 <para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
150 <link id="Amazon-Linux">Amazon Linux</link>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
151
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
152 <table note="yes">
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
153
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
154 <tr>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
155 <td width="30%">Version</td>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
156 <td>Supported platforms</td>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
157 </tr>
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%">2 (LTS)</td>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
161 <td>x86_64, aarch64/arm64</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 </table>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
165 </para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
166
2326
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
167 </section>
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
168
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
169
5d045e964270 Moved the repository introduction paragraph to an appropriate place.
Konstantin Pavlov <thresh@videolan.org>
parents: 2325
diff changeset
170 <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
171
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
172 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
173 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
174 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
175 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
176 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
177
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
178 <section name="RHEL/CentOS" id="RHEL-CentOS">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
179
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
180 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
181 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
182 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
183 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
184 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
185
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
186 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
187 <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
188 with the following contents:
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 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
191 [nginx-stable]
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
192 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
193 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
194 gpgcheck=1
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
195 enabled=1
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
196 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
197 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
198
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
199 [nginx-mainline]
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
200 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
201 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
202 gpgcheck=1
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
203 enabled=0
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
204 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
205 module_hotfixes=true
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
206 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
207
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
208 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
209 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
210 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
211 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
212 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
213 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
214
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
215 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
216 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
217 sudo yum install nginx
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
218 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
219
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
220 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
221 <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
222 and if so, accept it.
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
223 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
224
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
225 </section>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
226
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
227
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
228 <section name="Debian" id="Debian">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
229
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
230 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
231 Install the prerequisites:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
232 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
233 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
234 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
235 </para>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
236
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
237 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
238 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
239 authenticity.
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
240 Fetch the key:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
241 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
242 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
243 | 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
244 </programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
245
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
246 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
247 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
248 gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
249 </programlisting>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
250
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
251 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
252 <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
253 as follows:
1364
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
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 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
256 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
257 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
258 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
259 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
260 </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
261
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
262 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
263 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
264 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
265 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
266 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
267 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
268 | 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
269 </programlisting>
12d631cfbc9d Documented SLES 12 packages availability.
Konstantin Pavlov <thresh@nginx.com>
parents: 1253
diff changeset
270
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
271 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
272 run the following command instead:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
273 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
274 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
275 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
276 | 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
277 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
278 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
279
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
280 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
281 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
282 distribution-provided ones:
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 -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
285 | 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
286 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
287 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
288
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
289 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
290 To install nginx, run the following commands:
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
291 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
292 sudo apt update
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
293 sudo apt install nginx
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
294 </programlisting>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
295 </para>
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
296
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
297 </section>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
298
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
299
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
300 <section name="Ubuntu" id="Ubuntu">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
301
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
302 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
303 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
304 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
305 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
306 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
307 </para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
308
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
309 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
310 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
311 authenticity.
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
312 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
313 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
314 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
315 | 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
316 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
317
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
318 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
319 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
320 gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
2662
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
321 </programlisting>
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
322
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
323 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
324 <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
325 as follows:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
326 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
327 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
328 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
e4d370d43176 Linux packages: removed apt-key usage to import gpg keys on Debian/Ubuntu.
Konstantin Pavlov <thresh@nginx.com>
parents: 2661
diff changeset
329 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
330 </programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
331 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
332 </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
333
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
334 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
335 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
336 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
337 <programlisting>
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
338 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
339 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
340 | 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
341 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
342
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
343 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
344 run the following command instead:
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
345 <programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
346 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
347 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
348 | 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
349 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
350 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
351
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
352 <para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
353 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
354 distribution-provided ones:
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 -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
357 | 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
358 </programlisting>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
359 </para>
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
360
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
361 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
362 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
363 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
364 sudo apt update
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
365 sudo apt install nginx
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
366 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
367 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
368
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
369 </section>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
370
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
371
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
372 <section name="SLES" id="SLES">
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
373
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
374 <para>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
375 Install the prerequisites:
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
376 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
377 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
378 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
379
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
380 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
381 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
382 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
383 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
384 '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
385 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
386
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
387 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
388 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
389 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
390 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
391 '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
392 </programlisting>
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
393
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
394 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
395 the packages authenticity.
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
396 Fetch the key:
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
397 <programlisting>
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
398 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
399 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
400
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
401 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
402 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
403 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
404 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
405
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
406 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
407 <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
408 as follows:
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 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
411 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
412 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
413 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
414
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
415 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
416 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
417 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
418 </programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
419
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
420 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
421 <programlisting>
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
422 sudo zypper install nginx
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
423 </programlisting>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
424 </para>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
425
2322
bb03e6ac2f16 Added per-distro instructions on how to enable packages signature checks.
Konstantin Pavlov <thresh@videolan.org>
parents: 2321
diff changeset
426 </section>
2233
8f988cbe1296 Linux packages: added SLES 15.
Konstantin Pavlov <thresh@nginx.com>
parents: 2160
diff changeset
427
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
428
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
429 <section name="Alpine" id="Alpine">
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
430
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
431 <para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
432 Install the prerequisites:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
433 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
434 sudo apk add openssl curl ca-certificates
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
435 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
436
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
437 To set up the apk repository for stable nginx packages,
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
438 run the following command:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
439 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
440 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
441 "@nginx " \
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
442 "http://nginx.org/packages/alpine/v" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
443 `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
444 "/main" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
445 | sudo tee -a /etc/apk/repositories
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
446 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
447
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
448 If you would like to use mainline nginx packages,
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
449 run the following command instead:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
450 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
451 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
452 "@nginx " \
2323
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
453 "http://nginx.org/packages/mainline/alpine/v" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
454 `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
455 "/main" \
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
456 | sudo tee -a /etc/apk/repositories
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
457 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
458
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
459 Next, import an official nginx signing key so apk could verify
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
460 the packages authenticity.
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
461 Fetch the key:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
462 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
463 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
464 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
465
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
466 Verify that downloaded file contains the proper key:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
467 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
468 openssl rsa -pubin -in /tmp/nginx_signing.rsa.pub -text -noout
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
469 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
470
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
471 The output should contain the following modulus:
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 Public-Key: (2048 bit)
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
474 Modulus:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
475 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
476 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
477 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
478 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
479 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
480 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
481 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
482 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
483 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
484 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
485 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
486 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
487 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
488 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
489 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
490 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
491 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
492 ab:6d
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
493 Exponent: 65537 (0x10001)
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
494 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
495
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
496 Finally, move the key to apk trusted keys storage:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
497 <programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
498 sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
499 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
500
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
501 To install nginx, run the following command:
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
502 <programlisting>
2661
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
503 sudo apk add nginx@nginx
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
504 </programlisting>
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
505
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
506 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
507 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
508 <programlisting>
991cf4287c36 Linux packages: added repository pinning instructions for Alpine Linux.
Konstantin Pavlov <thresh@nginx.com>
parents: 2660
diff changeset
509 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
510 </programlisting>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
511 </para>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
512
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
513 </section>
eaef8f4ca921 Added Alpine Linux.
Konstantin Pavlov <thresh@videolan.org>
parents: 2322
diff changeset
514
2755
6eff5d63925b Linux packages: updated Debian and Ubuntu to best practices.
Konstantin Pavlov <thresh@nginx.com>
parents: 2754
diff changeset
515
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
516 <section name="Amazon Linux" id="Amazon-Linux">
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
517
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
518 <para>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
519 Install the prerequisites:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
520 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
521 sudo yum install yum-utils
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
522 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
523
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
524 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
525 <path>/etc/yum.repos.d/nginx.repo</path>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
526 with the following contents:
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 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
529 [nginx-stable]
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
530 name=nginx stable repo
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
531 baseurl=http://nginx.org/packages/amzn2/$releasever/$basearch/
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
532 gpgcheck=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
533 enabled=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
534 gpgkey=https://nginx.org/keys/nginx_signing.key
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
535 module_hotfixes=true
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
536
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
537 [nginx-mainline]
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
538 name=nginx mainline repo
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
539 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
540 gpgcheck=1
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
541 enabled=0
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
542 gpgkey=https://nginx.org/keys/nginx_signing.key
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
543 module_hotfixes=true
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
544 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
545
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
546 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
547 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
548 run the following command:
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
549 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
550 sudo yum-config-manager --enable nginx-mainline
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
551 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
552
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
553 To install nginx, run the following command:
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
554 <programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
555 sudo yum install nginx
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
556 </programlisting>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
557
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
558 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
559 <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
560 and if so, accept it.
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
561 </para>
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 </section>
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
564
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
565 </section>
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
566
932
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
567
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
568 <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
569
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
570 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
571 Packaging sources can be found in the
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
572 <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
573 </para>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
574
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
575 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
576 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
577 mainline version, while <literal>stable-*</literal> branches contain latest
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
578 sources for stable releases.
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
579 To build binary packages, run <command>make</command> in
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
580 <path>debian/</path> directory on Debian/Ubuntu, or in
2730
5235e67595b4 Linux packages: added Amazon Linux 2.
Konstantin Pavlov <thresh@nginx.com>
parents: 2699
diff changeset
581 <path>rpm/SPECS/</path> on RHEL/CentOS/SLES/Amazon Linux, or in
2625
987768ee3211 Linux packages: fixed path for Alpine package sources.
Konstantin Pavlov <thresh@nginx.com>
parents: 2619
diff changeset
582 <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
583 </para>
e739f2281571 Mentioned --with-stream_realip_module configure argument for mainline packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 1787
diff changeset
584
e739f2281571 Mentioned --with-stream_realip_module configure argument for mainline packages.
Konstantin Pavlov <thresh@nginx.com>
parents: 1787
diff changeset
585 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
586 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
587 <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
588 used by nginx.
1482
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
589 </para>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
590
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
591 </section>
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
592
f595fb427509 Configure arguments list for pre-built packages added.
Sergey Budnevitch <sb@waeme.net>
parents: 1470
diff changeset
593
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
594 <section name="Dynamic Modules" id="dynmodules">
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
595
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
596 <para>
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
597 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
598 libraries to avoid extra dependencies.
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
599 Since version 1.9.11, nginx supports
1922
94493c0ff5f6 Introduced "Source Packages" section.
Konstantin Pavlov <thresh@nginx.com>
parents: 1921
diff changeset
600 <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
601 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
602 packages:
1681
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
603 <programlisting>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
604 nginx-module-geoip
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
605 nginx-module-image-filter
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
606 nginx-module-njs
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
607 nginx-module-perl
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
608 nginx-module-xslt
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
609 </programlisting>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
610 </para>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
611
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
612 </section>
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
613
3a9097dc9d86 Linux packages for dynamic modules.
Fedor Dikarev <fe@nginx.com>
parents: 1661
diff changeset
614
932
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
615 <section name="Signatures" id="signatures">
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
616
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
617 <para>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
618 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
619 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
620 they are equally trusted.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
621 It is highly advised to additionally verify
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
622 the authenticity of the downloaded PGP key.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
623 PGP has the “Web of Trust” concept,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
624 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
625 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
626 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
627 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
628 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
629 This concept is described in details in
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
630 <link url="http://www.dewinter.com/gnupg_howto/english/GPGMiniHowto-1.html">
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
631 GPG Mini Howto</link>.
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
632 Our keys have enough signatures,
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
633 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
634 </para>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
635
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
636 </section>
774505846a54 Section about packages' and repositories' signatures added.
Sergey Budnevitch <sb@waeme.net>
parents: 915
diff changeset
637
882
d1002c39ac0a Linux packages related information moved to separate page.
Sergey Budnevitch <sb@waeme.net>
parents:
diff changeset
638 </article>