Skip to content

Add specific version instructions for NGINX Agent v2 installation #859

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 24, 2025
Merged

Add specific version instructions for NGINX Agent v2 installation #859

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
cb6e110
Add specific version instructions for NGINX Agent v2 installation
nginx-seanmoloney Jul 21, 2025
7a4f806
Remove lsb_release from instructions, use code name instead
nginx-seanmoloney Jul 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 21 additions & 18 deletions content/agent/installation-upgrade/installation-oss.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,10 +50,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
module_hotfixes=true
```

1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

```shell
sudo yum install nginx-agent
sudo yum install -y nginx-agent-2.42.0
```

When prompted to accept the GPG key, verify that the fingerprint matches `8540 A6F1 8833 A80E 9C16 53A4 2FD2 1310 B49F 6B46`, `573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62`, `9E9B E90E ACBC DE69 FE9B 204C BCDC D8A3 8D88 A2B3`, and if so, accept it.
Expand Down Expand Up @@ -105,11 +105,13 @@ Before you install NGINX Agent for the first time on your system, you need to se
| sudo tee /etc/apt/sources.list.d/nginx-agent.list
```

1. To install `nginx-agent`, run the following commands:

1. To install `nginx-agent` with a specific version (example: 2.42.0):

Update your package index and install a specific version of the nginx-agent. Replace <VERSION_CODENAME> with your current Ubuntu codename (e.g., jammy, noble).

```shell
sudo apt update
sudo apt install nginx-agent
sudo apt install -y nginx-agent=2.42.0~<VERSION_CODENAME>
```

1. Verify the installation:
Expand Down Expand Up @@ -166,12 +168,13 @@ Before you install NGINX Agent for the first time on your system, you need to se
http://packages.nginx.org/nginx-agent/debian/ `lsb_release -cs` agent" \ | sudo tee /etc/apt/sources.list.d/nginx-agent.list
```

1. To install `nginx-agent`, run the following commands:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

Update your package index and install a specific version of the nginx-agent. Replace <VERSION_CODENAME> with your current Debian codename (e.g., bullseye).

```shell
sudo apt update
sudo apt install nginx-agent
```
sudo apt install -y nginx-agent=2.42.0~<VERSION_CODENAME>
1. Verify the installation:
Expand Down Expand Up @@ -229,10 +232,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
sudo rpmkeys --import /tmp/nginx_signing.key
```
1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):
```shell
sudo zypper install nginx-agent
sudo zypper install -y nginx-agent=2.42.0
```
1. Verify the installation:
Expand Down Expand Up @@ -303,10 +306,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/
```
1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):
```shell
sudo apk add nginx-agent
sudo apk add nginx-agent=2.42.0
```
1. Verify the installation:
Expand Down Expand Up @@ -334,10 +337,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
module_hotfixes=true
```
1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):
```shell
sudo dnf install nginx-agent
sudo dnf install -y nginx-agent-2.42.0
```
1. When prompted to accept the GPG key, verify that the fingerprint matches
Expand Down Expand Up @@ -370,10 +373,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
module_hotfixes=true
```
1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):
```shell
sudo yum install nginx-agent
sudo yum install -y nginx-agent-2.42.0
```
1. When prompted to accept the GPG key, verify that the fingerprint matches `8540 A6F1 8833 A80E 9C16 53A4 2FD2 1310 B49F 6B46`, `573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62`, `9E9B E90E ACBC DE69 FE9B 204C BCDC D8A3 8D88 A2B3`, and if so, accept it.
Expand All @@ -396,10 +399,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
}
```
1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):
```shell
sudo pkg install nginx-agent
sudo pkg install nginx-agent-2.42.0
```
1. Verify the installation:
Expand Down
34 changes: 19 additions & 15 deletions content/agent/installation-upgrade/installation-plus.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,10 +73,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
enabled=1
```

1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

```shell
sudo yum install nginx-agent
sudo yum install -y nginx-agent-2.42.0
```

When prompted to accept the GPG key, verify that the fingerprint matches `8540 A6F1 8833 A80E 9C16 53A4 2FD2 1310 B49F 6B46`, `573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62`, `9E9B E90E ACBC DE69 FE9B 204C BCDC D8A3 8D88 A2B3`, and if so, accept it.
Expand Down Expand Up @@ -131,11 +131,13 @@ Before you install NGINX Agent for the first time on your system, you need to se
| sudo tee /etc/apt/sources.list.d/nginx-agent.list
```

1. To install `nginx-agent`, run the following commands:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

Update your package index and install a specific version of the nginx-agent. Replace <VERSION_CODENAME> with your current Ubuntu codename (e.g., jammy, noble).

```shell
sudo apt update
sudo apt install nginx-agent
sudo apt install -y nginx-agent=2.42.0~<VERSION_CODENAME>
```

1. Verify the installation:
Expand Down Expand Up @@ -183,12 +185,14 @@ Before you install NGINX Agent for the first time on your system, you need to se
Acquire::https::pkgs.nginx.com::SslKey "/etc/ssl/nginx/nginx-repo.key";
```

1. To install `nginx-agent`, run the following commands:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

Update your package index and install a specific version of the nginx-agent. Replace <VERSION_CODENAME> with your current Debian codename (e.g., bullseye).

```shell
sudo apt update
sudo apt install nginx-agent
```
sudo apt install -y nginx-agent=2.42.0~<VERSION_CODENAME>


1. Verify the installation:

Expand Down Expand Up @@ -265,10 +269,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
sudo rpmkeys --import /tmp/nginx_signing.key
```

1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

```shell
sudo zypper install nginx-agent
sudo zypper install -y nginx-agent=2.42.0
```

1. Verify the installation:
Expand Down Expand Up @@ -394,10 +398,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
enabled=1
```

1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

```shell
sudo dnf install nginx-agent
sudo dnf install -y nginx-agent-2.42.0
```

1. When prompted to accept the GPG key, verify that the fingerprint matches `8540 A6F1 8833 A80E 9C16 53A4 2FD2 1310 B49F 6B46`, `573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62`, `9E9B E90E ACBC DE69 FE9B 204C BCDC D8A3 8D88 A2B3`, and if so, accept it.
Expand Down Expand Up @@ -442,10 +446,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
enabled=1
```

1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

```shell
sudo yum install nginx-agent
sudo yum install -y nginx-agent-2.42.0
```

1. When prompted to accept the GPG key, verify that the fingerprint matches `8540 A6F1 8833 A80E 9C16 53A4 2FD2 1310 B49F 6B46`, `573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62`, `9E9B E90E ACBC DE69 FE9B 204C BCDC D8A3 8D88 A2B3`, and if so, accept it.
Expand Down Expand Up @@ -496,10 +500,10 @@ Before you install NGINX Agent for the first time on your system, you need to se
SSL_CLIENT_KEY_FILE: "/etc/ssl/nginx/nginx-repo.key" }
```

1. To install `nginx-agent`, run the following command:
1. To install `nginx-agent` with a specific version (example: 2.42.0):

```shell
sudo pkg install nginx-agent
sudo pkg install nginx-agent-2.42.0
```

1. Verify the installation:
Expand Down
8 changes: 4 additions & 4 deletions content/agent/installation-upgrade/upgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,10 +60,10 @@ To upgrade NGINX Agent to a specific **v2.x version**, follow these steps:
sudo apt-get install -y nginx-agent=<specific-version> -o Dpkg::Options::="--force-confold"
```

Example (to upgrade to version 2.41.1~noble):
Example (to upgrade to version 2.42.0~noble):

```shell
sudo apt-get install -y nginx-agent=2.41.1~noble -o Dpkg::Options::="--force-confold"
sudo apt-get install -y nginx-agent=2.42.0~noble -o Dpkg::Options::="--force-confold"
```

- CentOS, RHEL, RPM-Based
Expand All @@ -72,10 +72,10 @@ To upgrade NGINX Agent to a specific **v2.x version**, follow these steps:
sudo yum install -y nginx-agent-<specific-version>
```

Example (to upgrade to version `2.41.1`):
Example (to upgrade to version `2.42.0`):

```shell
sudo yum install -y nginx-agent-2.41.1
sudo yum install -y nginx-agent-2.42.0
```

1. Verify the installed version:
Expand Down