Skip to content

feat: Add version instructions for WAF virtual environments #1593

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

Open
ADubhlaoich wants to merge 4 commits into
base: main
Choose a base branch
from
+86 −0
Open

feat: Add version instructions for WAF virtual environments #1593

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d2f36a4
feat: Add version instructions for WAF virtual environments
ADubhlaoich Dec 17, 2025
3a3b807
Merge branch 'main' into waf/package-versions
ADubhlaoich Dec 17, 2025
a6bf3b7
Merge branch 'main' into waf/package-versions
ADubhlaoich Dec 17, 2025
a2d1d4a
Merge branch 'main' into waf/package-versions
ADubhlaoich Dec 18, 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
86 changes: 86 additions & 0 deletions content/waf/install/virtual-environment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,17 @@ sudo apk update
sudo apk add openssl ca-certificates app-protect
```

{{< details summary="Installing a specific version of F5 WAF for NGINX" >}}

If you need to install a specific version of F5 WAF for NGINX, you can use `apk info` to list available versions, then append it to the package name:

```shell
sudo apk info app-protect
sudo apk add openssl ca-certificates app-protect=<desired-version>
```

{{< /details >}}

### Amazon Linux

Add the F5 WAF for NGINX repository:
Expand All @@ -74,6 +85,17 @@ Install the F5 WAF for NGINX package and its dependencies:
sudo dnf install app-protect
```

{{< details summary="Installing a specific version of F5 WAF for NGINX" >}}

If you need to install a specific version of F5 WAF for NGINX, you can use `--showduplicates list` to list available versions, then append it to the package name:

```shell
sudo dnf --showduplicates list app-protect
sudo dnf install app-protect-=<desired-version>
```

{{< /details >}}

### Debian

Add the F5 WAF for NGINX signing key:
Expand Down Expand Up @@ -102,6 +124,27 @@ sudo apt-get update
sudo apt-get install app-protect
```

{{< details summary="Installing a specific version of F5 WAF for NGINX" >}}

If you need to install a specific version of F5 WAF for NGINX, you can use `apt-cache` to list available versions, then append it to the package name:

```shell
sudo apt-get update
sudo apt-cache policy app-protect
sudo apt-get install app-protect=<desired-version>
```

When installing a specific version of F5 WAF for NGINX, you will also need to manually install its package dependencies.

You can use the following script to get the dependent packages:

```shell
findDeps () { local pkgs=$(apt show $1 2>/dev/null | grep Depends: | grep -oE "(nginx-plus-module|app-protect)-[a-z]+ *\(= *[0-9\+\.-]+~`lsb_release -cs`\)" | tr -d ' ()'); for p in ${pkgs[@]}; do echo $p; findDeps $p; done; }
findDeps app-protect=<desired-version>
```

{{< /details >}}

### Oracle Linux / RHEL / Rocky Linux 8

{{< call-out "important" >}}
Expand Down Expand Up @@ -140,6 +183,17 @@ Install the F5 WAF for NGINX package and its dependencies:
sudo dnf install app-protect
```

{{< details summary="Installing a specific version of F5 WAF for NGINX" >}}

If you need to install a specific version of F5 WAF for NGINX, you can use `--showduplicates list` to list available versions, then append it to the package name:

```shell
sudo dnf --showduplicates list app-protect
sudo dnf install app-protect-=<desired-version>
```

{{< /details >}}

### RHEL / Rocky Linux 9

Add the F5 WAF for NGINX repository:
Expand All @@ -166,6 +220,17 @@ Install the F5 WAF for NGINX package and its dependencies:
sudo dnf install app-protect
```

{{< details summary="Installing a specific version of F5 WAF for NGINX" >}}

If you need to install a specific version of F5 WAF for NGINX, you can use `--showduplicates list` to list available versions, then append it to the package name:

```shell
sudo dnf --showduplicates list app-protect
sudo dnf install app-protect-=<desired-version>
```

{{< /details >}}

### Ubuntu

Add the F5 WAF for NGINX signing key:
Expand Down Expand Up @@ -194,6 +259,27 @@ sudo apt-get update
sudo apt-get install app-protect
```

{{< details summary="Installing a specific version of F5 WAF for NGINX" >}}

If you need to install a specific version of F5 WAF for NGINX, you can use `apt-cache` to list available versions, then append it to the package name:

```shell
sudo apt-get update
sudo apt-cache policy app-protect
sudo apt-get install app-protect=<desired-version>
```

When installing a specific version of F5 WAF for NGINX, you will also need to manually install its package dependencies.

You can use the following script to get the dependent packages:

```shell
findDeps () { local pkgs=$(apt show $1 2>/dev/null | grep Depends: | grep -oE "(nginx-plus-module|app-protect)-[a-z]+ *\(= *[0-9\+\.-]+~`lsb_release -cs`\)" | tr -d ' ()'); for p in ${pkgs[@]}; do echo $p; findDeps $p; done; }
findDeps app-protect=<desired-version>
```

{{< /details >}}

## Update configuration files

Once you have installed F5 WAF for NGINX, you must load it as a module in the main context of your NGINX configuration.
Expand Down