From a0750dce549082e763c22fc78fff913a3f4908eb Mon Sep 17 00:00:00 2001
From: Jon Cahill-Torre <j.cahilltorre@f5.com>
Date: Wed, 1 Oct 2025 11:40:02 +0100
Subject: [PATCH 1/2] docs: add config agent features

---
 .../configure-agent-features.md               | 100 ++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 content/nginx-one/agent/configure-instances/configure-agent-features.md

diff --git a/content/nginx-one/agent/configure-instances/configure-agent-features.md b/content/nginx-one/agent/configure-instances/configure-agent-features.md
new file mode 100644
index 000000000..c940622a8
--- /dev/null
+++ b/content/nginx-one/agent/configure-instances/configure-agent-features.md
@@ -0,0 +1,100 @@
+---
+title: Features configuration
+weight: 350
+toc: true
+nd-docs: DOCS-000
+nd-content-type: how-to
+---
+
+## Overview
+
+This guide describes the F5 NGINX Agent features, and how to enable and disable them using the NGINX Agent configuration file, CLI flags, environment variables, and gRPC updates.
+
+## Before you begin
+
+Before you start, make sure that you have:
+
+- [NGINX Agent installed]({{< ref "/nginx-one/agent/install-upgrade/" >}}) in your system.
+- Access to the NGINX Agent configuration file, CLI, or container environment.
+
+## Features
+
+The following table lists the NGINX Agent features:
+
+{{< table "features" >}}
+| Feature Name        | Description                                                                 | Default |
+| ------------------- | --------------------------------------------------------------------------- | ------- |
+| configuration       | Full read/write management of configurations, controlled by DataPlaneConfig ConfigMode. | On      |
+| certificates        | Inclusion of public keys and other certificates in the configurations toggled by DataPlaneConfig CertMode                 | Off     |
+| connection          | Sends an initial connection message reporting instance information on presence of Command ServerConfig Host and Port                 | On      |
+| file-watcher        | Monitoring of file changes in the allowed directories list and references from product configs.             | On      |
+| agent-api           | REST API for NGINX Agent.                                                    | Off     |
+| metrics             | Full metrics reporting.                                                      | On      |
+| > metrics-host      | Host-level metrics (cpu, disk, load, fs, memory, network, paging).           | On      |
+| > metrics-container | Container-level metrics from cgroup information.                             | On      |
+| > metrics-instance  | OSS and Plus metrics depending on NGINX instance.                            | On      |
+| logs                | Collection and reporting of NGINX error logs.                                | Off     |
+| > logs-nap          | F5 WAF for NGINX logs.                                                       | Off     |
+{{< /table >}}
+
+## Configuration sources
+
+You can enable or disable features using several configuration sources:
+
+### CLI parameters
+
+Enable features at launch:
+
+   ```shell
+   ./nginx-agent --features=connection,configuration,metrics,file-watcher,agent-api
+   ```
+
+### Environment variables
+
+Use environment variables for containerized deployments:
+
+   ```shell
+   export NGINX_AGENT_FEATURES="connection,configuration,metrics,file-watcher,agent-api"
+   ```
+
+### Configuration file
+
+Define features in the `nginx-agent.conf` file:
+
+   ```yaml
+   features:
+   - connection
+   - configuration
+   - metrics
+   - file-watcher
+   - agent-api
+   ```
+
+## Use cases
+
+### Enable metrics only
+
+1. Access the NGINX instance: Connect using SSH to the VM or server where NGINX Agent is running.
+
+   `ssh user@your-nginx-instance`
+
+1. Open the NGINX Agent configuration file in a text editor.
+
+   `sudo vim /etc/nginx-agent/nginx-agent.conf`
+
+1. Add the features section: Add the following to the end of the configuration file if it doesn't already exist.
+
+   ```yaml
+   features:
+   - metrics
+   - metrics-host
+   - metrics-container
+   - metrics-instance
+   ```
+
+1. Restart the NGINX Agent service to apply the changes.
+
+   `sudo systemctl restart nginx-agent`
+
+Once the steps have been completed, users will be able to view metrics data being sent but will not have the capability to push NGINX configuration changes.
+

From 3c8d5c9a908622fea89905f9e10b563623fe0076 Mon Sep 17 00:00:00 2001
From: Jon Torre <78599298+JTorreG@users.noreply.github.com>
Date: Mon, 6 Oct 2025 12:25:53 +0100
Subject: [PATCH 2/2] Update
 content/nginx-one/agent/configure-instances/configure-agent-features.md

Co-authored-by: Alan Dooley <a.dooley@f5.com>
---
 .../agent/configure-instances/configure-agent-features.md       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/nginx-one/agent/configure-instances/configure-agent-features.md b/content/nginx-one/agent/configure-instances/configure-agent-features.md
index c940622a8..81957964f 100644
--- a/content/nginx-one/agent/configure-instances/configure-agent-features.md
+++ b/content/nginx-one/agent/configure-instances/configure-agent-features.md
@@ -1,5 +1,5 @@
 ---
-title: Features configuration
+title: Review and configure features
 weight: 350
 toc: true
 nd-docs: DOCS-000