Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
4 changes: 2 additions & 2 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@ content/nginx/nms/agent/* @nginx/nginx-agent
content/nap-dos/* @nginx/dos-docs-approvers

# F5 WAF for NGINX
content/nap-waf/* @nginx/nap-docs-approvers
data/nap-waf/* @nginx/nap-docs-approvers
content/waf/* @nginx/waf
content/includes/waf/* @nginx/waf

# NGINXaaS for Azure
content/nginxaas-azure/* @nginx/n4a-docs-approvers
Expand Down
19 changes: 8 additions & 11 deletions content/agent/configuration/configuration-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,9 @@ title: Basic configuration
draft: false
weight: 100
toc: true
nd-docs: DOCS-1229
nd-content-type: how-to
nd-product: Agent
nd-docs: DOCS-1229
---

The following sections explain how to configure NGINX Agent using configuration files, CLI flags, and environment variables.
Expand All @@ -27,8 +28,7 @@ The default locations of configuration files for NGINX Agent are `/etc/nginx-age

Examples of the configuration files are provided below:

<details open>
<summary>example nginx-agent.conf</summary>
{{< details summary="Open nginx-agent.conf example">}}

{{< call-out "note" >}}
In the following example `nginx-agent.conf` file, you can change the `server.host` and `server.grpcPort` to connect to the control plane.
Expand Down Expand Up @@ -112,11 +112,9 @@ nginx_app_protect:
precompiled_publication: true
```

</details>

{{< /details >}}

<details open>
<summary>example dynamic-agent.conf</summary>
{{< details summary="Open dynamic-agent.conf example">}}

{{< call-out "note" >}}
Default location in Linux environments: `/var/lib/nginx-agent/agent-dynamic.conf`
Expand Down Expand Up @@ -146,7 +144,7 @@ tags:
- qa
```

</details>
{{< /details >}}

## CLI Flags & Environment Variables

Expand Down Expand Up @@ -239,8 +237,7 @@ Default location in FreeBSD environments: `/var/db/nginx-agent/agent-dynamic.con

By default, NGINX Agent rotates logs daily using logrotate with the following configuration:

<details open>
<summary>NGINX Agent Logrotate Configuration</summary>
{{< details summary="Logrotate configuration example" >}}

``` yaml
/var/log/nginx-agent/*.log
Expand All @@ -263,7 +260,7 @@ By default, NGINX Agent rotates logs daily using logrotate with the following co
notifempty
}
```
</details>
{{< /details >}}

If you need to change the default configuration, update the file at `/etc/logrotate.d/nginx-agent`.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,9 @@
nd-docs: "DOCS-1662"
---

<details closed>
<summary style="font-weight:bold">View the full contents of the license_usage_offline.sh script</summary>
{{< details summary="Full license_usage_offline.sh script" >}}

``` bash
```shell
#!/bin/bash

# Function to encode the username and password to base64
Expand Down Expand Up @@ -413,4 +412,4 @@ curl --insecure --location "https://$ip_address/api/platform/v1/report/upload" \
echo "Report acknowledgement successfully uploaded to NGINX Instance Manager $ip_address."
```

</details>
{{< /details >}}
5 changes: 2 additions & 3 deletions content/ngf/install/helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,7 @@ To complete this guide, you will need:

{{< call-out "important" >}} If you’d like to use NGINX Plus, some additional setup is also required: {{< /call-out >}}

<details closed>
<summary>NGINX Plus JWT setup</summary>
{{< details summary="NGINX Plus JWT setup" >}}

{{< include "/ngf/installation/jwt-password-note.md" >}}

Expand All @@ -41,7 +40,7 @@ To complete this guide, you will need:

{{< call-out "note" >}} For more information on why this is needed and additional configuration options, including how to report to NGINX Instance Manager instead, see the [NGINX Plus Image and JWT Requirement]({{< ref "/ngf/install/nginx-plus.md" >}}) document. {{< /call-out >}}

</details>
{{< /details >}}

## Deploy NGINX Gateway Fabric

Expand Down
5 changes: 2 additions & 3 deletions content/ngf/install/manifests.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,7 @@ To complete this guide, you'll need to install:

{{< call-out "important" >}} If you’d like to use NGINX Plus, some additional setup is also required: {{< /call-out >}}

<details closed>
<summary>NGINX Plus JWT setup</summary>
{{< details summary="NGINX Plus JWT setup" >}}

{{< include "/ngf/installation/jwt-password-note.md" >}}

Expand All @@ -39,7 +38,7 @@ To complete this guide, you'll need to install:

{{< call-out "note" >}} For more information on why this is needed and additional configuration options, including how to report to NGINX Instance Manager instead, see the [NGINX Plus Image and JWT Requirement]({{< ref "/ngf/install/nginx-plus.md" >}}) document. {{< /call-out >}}

</details>
{{< /details >}}

## Deploy NGINX Gateway Fabric

Expand Down
52 changes: 23 additions & 29 deletions content/nginx-one/agent/install-upgrade/install-from-oss-repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,59 +29,53 @@ Before you install NGINX Agent for the first time on your system, you need to se
up the `nginx-agent` packages repository. Afterward, you can install and update
NGINX Agent from the repository.

<details>
<summary>Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>

### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
### Install NGINX Agent on Alpine Linux

{{< include "/agent/installation/oss/oss-rhel.md" >}}
{{< details summary="Expand instructions" >}}

</details>
{{< include "/agent/installation/oss/oss-alpine.md" >}}

<details>
<summary>Install NGINX Agent on Ubuntu</summary>
{{< /details >}}

### Install NGINX Agent on Ubuntu
### Install NGINX Agent on Amazon Linux

{{< include "/agent/installation/oss/oss-ubuntu.md" >}}
{{< details summary="Expand instructions" >}}

</details>
{{< include "/agent/installation/oss/oss-amazon-linux.md" >}}

<details>
<summary>Install NGINX Agent on Debian</summary>
{{< /details >}}

### Install NGINX Agent on Debian

{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/oss/oss-debian.md" >}}

</details>
{{< /details >}}

<details>
<summary>Install NGINX Agent on SLES</summary>
### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux

### Install NGINX Agent on SLES
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/oss/oss-sles.md" >}}
{{< include "/agent/installation/oss/oss-rhel.md" >}}

</details>
{{< /details >}}

<details>
<summary>Install NGINX Agent on Alpine Linux</summary>
### Install NGINX Agent on SLES

### Install NGINX Agent on Alpine Linux
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/oss/oss-alpine.md" >}}
{{< include "/agent/installation/oss/oss-sles.md" >}}

</details>
{{< /details >}}

<details>
<summary>Install NGINX Agent on Amazon Linux</summary>
### Install NGINX Agent on Ubuntu

### Install NGINX Agent on Amazon Linux
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/oss/oss-amazon-linux.md" >}}
{{< include "/agent/installation/oss/oss-ubuntu.md" >}}

</details>
{{< /details >}}

### Manually connect NGINX Agent to NGINX One Console

Expand Down
59 changes: 27 additions & 32 deletions content/nginx-one/agent/install-upgrade/install-from-plus-repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@
title: Install from NGINX Plus repo
toc: true
weight: 200
docs: DOCS-000
nd-content-type: how-to
nd-product: NGINX One
nd-docs: DOCS-1877
---

Expand All @@ -16,7 +17,7 @@ For a quick guide on how to connect your instance to NGINX One Console see: [Con

## Overview

Follow the steps in this guide to install NGINX Agent in your NGINX instance using
Follow the steps in this guide to install F5 NGINX Agent in your NGINX instance using
the NGINX Plus repository.

## Before you begin
Expand All @@ -29,59 +30,53 @@ Before you install NGINX Agent for the first time on your system, you need to
set up the `nginx-agent` packages repository. Afterward, you can install and update
NGINX Agent from the repository.

### Install NGINX Agent on Alpine Linux

<details>
<summary>Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
{{< details summary="Expand instructions" >}}

### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux<a name="install-nginx-agent-on-rhel-centos-rocky-linux-almalinux-and-oracle-linux-plus"></a>

{{< include "/agent/installation/plus/plus-rhel.md" >}}
{{< include "/agent/installation/plus/plus-alpine.md" >}}

</details>
{{< /details >}}

<details>
<summary>Install NGINX Agent on Ubuntu</summary>
### Install NGINX Agent on Amazon Linux

### Install NGINX Agent on Ubuntu<a name="install-nginx-agent-on-ubuntu-plus"></a>
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/plus/plus-ubuntu.md" >}}
{{< include "/agent/installation/plus/plus-amazon-linux.md" >}}

</details>
{{< /details >}}

<details>
<summary>Install NGINX Agent on Debian</summary>
### Install NGINX Agent on Debian

### Install NGINX Agent on Debian<a name="install-nginx-agent-on-debian-plus"></a>
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/plus/plus-debian.md" >}}

</details>
{{< /details >}}

<details>
<summary>Install NGINX Agent on SLES</summary>
### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux

### Install NGINX Agent on SLES<a name="install-nginx-agent-on-sles-plus"></a>
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/plus/plus-sles.md" >}}
{{< include "/agent/installation/plus/plus-rhel.md" >}}

</details>
{{< /details >}}

<details>
<summary>Install NGINX Agent on Alpine Linux</summary>
### Install NGINX Agent on SLES

### Install NGINX Agent on Alpine Linux<a name="install-nginx-agent-on-alpine-linux-plus"></a>
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/plus/plus-alpine.md" >}}
{{< include "/agent/installation/plus/plus-sles.md" >}}

</details>
<details>
<summary>Install NGINX Agent on Amazon Linux</summary>
{{< /details >}}

### Install NGINX Agent on Amazon Linux<a name="install-nginx-agent-on-amazon-linux-plus"></a>
### Install NGINX Agent on Ubuntu

{{< include "/agent/installation/plus/plus-amazon-linux.md" >}}
{{< details summary="Expand instructions" >}}

{{< include "/agent/installation/plus/plus-ubuntu.md" >}}

</details>
{{< /details >}}

### Manually connect NGINX Agent to NGINX One Console

Expand Down
Loading