Skip to content

Commit 4fb2c88

Browse files
authored
fix: add acme, openssl build procedure, https for repo urls in oss install (#1530)
fix: acme module, openssl build procedure, https for repo urls in nginx oss install
1 parent c5e767a commit 4fb2c88

File tree

1 file changed

+19
-36
lines changed

1 file changed

+19
-36
lines changed

content/nginx/admin-guide/installing-nginx/installing-nginx-open-source.md

Lines changed: 19 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -147,6 +147,7 @@ The repository contains the latest versions of the following packages:
147147
| `nginx-module-perl` | The [`ngx_http_perl_module`](https://nginx.org/en/docs/http/ngx_http_perl_module.html) as a [dynamic module](#dynamic-modules). |
148148
| `nginx-module-xslt` | The [`ngx_http_xsl_module`](https://nginx.org/en/docs/http/ngx_http_xslt_module.html) as a [dynamic module](#dynamic-modules). |
149149
| `nginx-module-otel` | The [`ngx_otel_module`](https://nginx.org/en/docs/ngx_otel_module.html) as a [dynamic module](#dynamic-modules). |
150+
| `nginx-module-acme` | The [`ngx_http_acme_module`](https://nginx.org/en/docs/http/ngx_http_acme_module.html) as a [dynamic module](#dynamic-modules). |
150151
{{</bootstrap-table>}}
151152

152153

@@ -169,15 +170,15 @@ Before installing, check if your operating system and architecture are supported
169170
```text
170171
[nginx-stable]
171172
name=nginx stable repo
172-
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
173+
baseurl=https://nginx.org/packages/centos/$releasever/$basearch/
173174
gpgcheck=1
174175
enabled=1
175176
gpgkey=https://nginx.org/keys/nginx_signing.key
176177
module_hotfixes=true
177178
178179
[nginx-mainline]
179180
name=nginx mainline repo
180-
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
181+
baseurl=https://nginx.org/packages/mainline/centos/$releasever/$basearch/
181182
gpgcheck=1
182183
enabled=0
183184
gpgkey=https://nginx.org/keys/nginx_signing.key
@@ -311,15 +312,15 @@ Before installing, check if your operating system and architecture are supported
311312

312313
```shell
313314
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
314-
http://nginx.org/packages/debian `lsb_release -cs` nginx" \
315+
https://nginx.org/packages/debian `lsb_release -cs` nginx" \
315316
| sudo tee /etc/apt/sources.list.d/nginx.list
316317
```
317318

318319
- For `mainline`:
319320

320321
```shell
321322
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
322-
http://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
323+
https://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
323324
| sudo tee /etc/apt/sources.list.d/nginx.list
324325
```
325326

@@ -418,15 +419,15 @@ Before installing, check if your operating system and architecture are supported
418419
- For `stable`:
419420
```shell
420421
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
421-
http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
422+
https://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
422423
| sudo tee /etc/apt/sources.list.d/nginx.list
423424
```
424425

425426
- For `mainline`:
426427

427428
```shell
428429
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
429-
http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
430+
https://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
430431
| sudo tee /etc/apt/sources.list.d/nginx.list
431432
```
432433

@@ -494,14 +495,14 @@ Before installing, check if your operating system and architecture are supported
494495

495496
```shell
496497
sudo zypper addrepo --gpgcheck --type yum --refresh --check \
497-
'http://nginx.org/packages/sles/$releasever_major' nginx-stable
498+
'https://nginx.org/packages/sles/$releasever_major' nginx-stable
498499
```
499500

500501
- For `mainline`:
501502

502503
```shell
503504
sudo zypper addrepo --gpgcheck --type yum --refresh --check \
504-
'http://nginx.org/packages/mainline/sles/$releasever_major' nginx-mainline
505+
'https://nginx.org/packages/mainline/sles/$releasever_major' nginx-mainline
505506
```
506507

507508
3. Import the official nginx signing key so `zypper` and `rpm` could verify the packages authenticity. Fetch the key:
@@ -588,7 +589,7 @@ Before installing, check if your operating system and architecture are supported
588589
```shell
589590
printf "%s%s%s%s\n" \
590591
"@nginx " \
591-
"http://nginx.org/packages/alpine/v" \
592+
"https://nginx.org/packages/alpine/v" \
592593
`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
593594
"/main" \
594595
| sudo tee -a /etc/apk/repositories
@@ -600,7 +601,7 @@ Before installing, check if your operating system and architecture are supported
600601
```shell
601602
printf "%s%s%s%s\n" \
602603
"@nginx " \
603-
"http://nginx.org/packages/mainline/alpine/v" \
604+
"https://nginx.org/packages/mainline/alpine/v" \
604605
`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
605606
"/main" \
606607
| sudo tee -a /etc/apk/repositories
@@ -710,15 +711,15 @@ Before installing, check if your operating system and architecture are supported
710711
```none
711712
[nginx-stable]
712713
name=nginx stable repo
713-
baseurl=http://nginx.org/packages/amzn2/$releasever/$basearch/
714+
baseurl=https://nginx.org/packages/amzn2/$releasever/$basearch/
714715
gpgcheck=1
715716
enabled=1
716717
gpgkey=https://nginx.org/keys/nginx_signing.key
717718
module_hotfixes=true
718719
719720
[nginx-mainline]
720721
name=nginx mainline repo
721-
baseurl=http://nginx.org/packages/mainline/amzn2/$releasever/$basearch/
722+
baseurl=https://nginx.org/packages/mainline/amzn2/$releasever/$basearch/
722723
gpgcheck=1
723724
enabled=0
724725
gpgkey=https://nginx.org/keys/nginx_signing.key
@@ -795,15 +796,15 @@ Before installing, check if your operating system and architecture are supported
795796
```none
796797
[nginx-stable]
797798
name=nginx stable repo
798-
baseurl=http://nginx.org/packages/amzn/2023/$basearch/
799+
baseurl=https://nginx.org/packages/amzn/2023/$basearch/
799800
gpgcheck=1
800801
enabled=1
801802
gpgkey=https://nginx.org/keys/nginx_signing.key
802803
module_hotfixes=true
803804
804805
[nginx-mainline]
805806
name=nginx mainline repo
806-
baseurl=http://nginx.org/packages/mainline/amzn/2023/$basearch/
807+
baseurl=https://nginx.org/packages/mainline/amzn/2023/$basearch/
807808
gpgcheck=1
808809
enabled=0
809810
gpgkey=https://nginx.org/keys/nginx_signing.key
@@ -908,7 +909,7 @@ In addition to core modules, the `nginx` package includes other nginx modules th
908909
|Module Name | Description |
909910
| -------------------------| ---------------------------------------------|
910911
| `--with-compat` |Enables dynamic modules compatibility. |
911-
| `--with-file-aio` |Enables the use of [asynchronous file I/O](https:/ /nginx.org/en/docs/http/ngx_http_core_module.html#aio) (AIO) on FreeBSD and Linux. |
912+
| `--with-file-aio` |Enables the use of [asynchronous file I/O](https://nginx.org/en/docs/http/ngx_http_core_module.html#aio) (AIO) on FreeBSD and Linux. |
912913
| `--with-threads` | Enables NGINX to use thread pools. For details, see [Thread Pools in NGINX Boost Performance 9x!](https://www.nginx.com/blog/thread-pools-boost-performance-9x/) on the NGINX blog. |
913914
|[`--with-http_addition_module`](https://nginx.org/en/docs/http/ngx_http_addition_module.html)| Adds text before and after a response. |
914915
|[`--with-http_auth_request_module`](https://nginx.org/en/docs/http/ngx_http_auth_request_module.html)|Implements client authorization based on the result of a subrequest. |
@@ -947,6 +948,7 @@ Some modules, especially those with external dependencies, are not included in t
947948
| [`ngx_http_perl_module`](https://nginx.org/en/docs/http/ngx_http_perl_module.html) | Implements location and variable handlers in Perl and inserts Perl calls into SSI. | `nginx-module-perl` |
948949
| [`ngx_http_xsl_module`](https://nginx.org/en/docs/http/ngx_http_xslt_module.html) | Transforms XML responses using one or more XSLT stylesheets. | `nginx-module-xslt` |
949950
| [`ngx_otel_module`](https://nginx.org/en/docs/ngx_otel_module.html) | Provides OpenTelemetry distributed tracing support. | `nginx-module-otel` |
951+
| [`ngx_http_acme_module`](https://nginx.org/en/docs/http_ngx_http_acme_module.html) | Implements the automatic certificate management (ACMEv2) protocol. | `nginx-module-acme` |
950952
{{</bootstrap-table>}}
951953
952954
## Compile and install from source {#sources}
@@ -982,27 +984,8 @@ Prior to compiling NGINX Open Source from source, you need to install libraries
982984
- [OpenSSL](https://www.openssl.org/) – Supports the HTTPS protocol. Required by the NGINX [SSL](https://nginx.org/en/docs/http/ngx_http_ssl_module.html) module and others.
983985
984986
```shell
985-
wget http://www.openssl.org/source/openssl-3.0.13.tar.gz
986-
tar -zxf openssl-3.0.13.tar.gz
987-
cd openssl-3.0.13
988-
./Configure darwin64-x86_64-cc --prefix=/usr
989-
make
990-
sudo make install
991-
```
992-
993-
Example for Ubuntu and Debian:
994-
```shell
995-
wget https://www.openssl.org/source/openssl-3.0.13.tar.gz
996-
tar -zxf openssl-3.0.13.tar.gz
997-
cd openssl-3.0.13
998-
./config --prefix=/usr/local --openssldir=/usr/local/ssl
999-
make -j$(nproc)
1000-
sudo make install
1001-
```
1002-
1003-
Example for RHEL-based:
1004-
```shell
1005-
curl -LO https://www.openssl.org/source/openssl-3.0.13.tar.gz
987+
wget https://www.openssl.org/source/openssl-3.0.13.tar.gz #for Ubuntu and Debian
988+
# curl -LO https://www.openssl.org/source/openssl-3.0.13.tar.gz #for RHEL-based:
1006989
tar -zxf openssl-3.0.13.tar.gz
1007990
cd openssl-3.0.13
1008991
./config --prefix=/usr/local --openssldir=/usr/local/ssl

0 commit comments

Comments
 (0)