+
From 5108457a8ac66dd4cef98444f7c0daaa64a1de3a Mon Sep 17 00:00:00 2001
From: Jack Hickey <133868041+nginx-jack@users.noreply.github.com>
Date: Mon, 23 Jun 2025 15:09:52 +0100
Subject: [PATCH 3/8] Homepage: Match mainframe css and layout setup
---
layouts/catalogs/single.html | 6 +-
layouts/index.html | 255 ++++++++++++++++++++++++++---------
2 files changed, 194 insertions(+), 67 deletions(-)
diff --git a/layouts/catalogs/single.html b/layouts/catalogs/single.html
index ca27eff9f..b1fb68f10 100644
--- a/layouts/catalogs/single.html
+++ b/layouts/catalogs/single.html
@@ -1,10 +1,7 @@
{{ define "main" }}
+ NGINX Product Documentation
-
-
-
-
-
+
+
+
+
-
-
- 
-
-
-
- NGINX Plus
-
-
- The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
-
+
@@ -214,17 +185,220 @@
+
+
+ NGINX One Console
+
+
+
+ Monitor your infrastructure, address security vulnerabilities, and assess the health of your NGINX fleet, all from a single console.
+
+
+ + NGINX One Console +
+
+
+
+
+
+
+
+
+
+
+
+
+ NGINX Plus
+
+
+ The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+ NGINX Instance Manager
+
+
+ Track and control NGINX Open Source and NGINX Plus instances.
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+ NGINX Ingress Controller
+
+
+ Kubernetes traffic management with API gateway, identity, and observability features
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+ NGINX Gateway Fabric
+
+
+ Next generation Kubernetes connectivity using the Gateway API.
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+ NGINX Open Source
+
+
+ The open source all-in-one load balancer, content cache, and web server
+
+
+
+
+
+
+
+
+
+
+
+
+
+ NGINX Agent
+
+
+ A daemon providing observability data and remote configuration for NGINX Open Source and NGINX Plus instances
+
+
+
+
+
+
+
+
+
+
+
+ Subscription Licensing & Solutions
+
+
+ Stay compliant with your NGINX subscription licenses and see how you can use NGINX One to build secure, scalable, and high-performing applications and APIs.
-
- NGINX Unit
+
+
+
+
+
+ NGINX App Protect
-
- Dynamic app server that can run beside NGINX, NGINX Plus, or on its own
+
+
+
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+ NGINX App Protect WAF
+
+
+ Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs
+
+
+
+
+
+
+
+ 
+
+
+
+ NGINX App Protect DoS
+
+
+ Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs
+
+
+
+
+
+
+ NGINX as a Service
+
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+ NGINX as a Service for Azure
+
+
+ Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack
+
+
-
+ More NGINX Products
+
+
+
+
+
+
+
+
+
+
+
+
+ NGINX Unit
+
+
+ Dynamic app server that can run beside NGINX, NGINX Plus, or on its own
+
+
-
-
+
{{ .Content }}
@@ -14,4 +11,3 @@
{{end }}
{{ end }}
-
diff --git a/layouts/index.html b/layouts/index.html
index 307953716..ffd91fb72 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -309,96 +309,227 @@
+
+ + NGINX One +
+ +
+
+
-
+
+
+
+
+
+ + NGINX One Console +
+
+ Monitor your infrastructure, address security vulnerabilities, and assess the health of your NGINX fleet, all from a single console.
+
+
-
- NGINX App Protect
+
+
+
+
-
-
+
+
+
+
+
+
+ NGINX Plus
+
+ The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
+
+
-
-
-
-
-
-
- NGINX App Protect WAF
-
+
+
+
+
+
+
+
+
+
-
- Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs
+
+
+ NGINX Instance Manager
+
+
+ Track and control NGINX Open Source and NGINX Plus instances.
+
+
+
+
-
-
+
+
+
+
+ NGINX Ingress Controller
-
+
+ Kubernetes traffic management with API gateway, identity, and observability features
+
+
-
-
-
-
-
-
- NGINX App Protect DoS
-
+
+
+
+
-
+
+
+
+
+
+
-
- Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs
+
+
+ NGINX Gateway Fabric
+
+
+ Next generation Kubernetes connectivity using the Gateway API.
+
+
+
+
+
+
+
+
+ NGINX Open Source
-
-
+ The open source all-in-one load balancer, content cache, and web server
+
+
-
- NGINX as a Service
+
+
+
+
-
+
+
+
+
+
+
+
+ NGINX Agent
+
+
+ A daemon providing observability data and remote configuration for NGINX Open Source and NGINX Plus instances
+
-
-
+
-
-
-
-
-
- NGINX as a Service for Azure
-
+
+
+
+
+
+
+
+ Subscription Licensing & Solutions
+
+ Stay compliant with your NGINX subscription licenses and see how you can use NGINX One to build secure, scalable, and high-performing applications and APIs.
+
+
- Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack
+
+
+
+
+
+
+ NGINX App Protect
+
+
+
+
+
+
+
+
+
+
-
+
+
+
+
+
+ NGINX App Protect WAF
+ Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs
+
+
+
+
+
+
+
+
+
+
+
+ NGINX App Protect DoS
+
+
+ Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs
+
+
+
+ NGINX as a Service
+
+
+
+
-
+
+
+
+
+ NGINX as a Service for Azure
+
+
-
-
-
- More NGINX Products
+
+
+
+ Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack
+
- }}
+ {{}}
+ {{}}
+ Monitor your infrastructure, address security vulnerabilities, and assess the health of your NGINX fleet, all from a single console.
+ {{ }}
+ {{}}
+ The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
+ {{ }}
+ {{}}
+ Track and control NGINX Open Source and NGINX Plus instances.
+ {{ }}
+ {{}}
+ Kubernetes traffic management with API gateway, identity, and observability features.
+ {{ }}
+ {{}}
+ Next generation Kubernetes connectivity using the Gateway API.
+ {{ }}
+ {{}}
+ The open source all-in-one load balancer, content cache, and web server
+ {{ }}
+ {{}}
+ A daemon providing observability data and remote configuration for NGINX Open Source and NGINX Plus instances
+ {{ }}
+ {{}}
+ Stay compliant with your NGINX subscription licenses and see how you can use NGINX One to build secure, scalable, and high-performing applications and APIs.
+ {{ }}
+ {{ }}
+
+ {{}}
+ {{}}
+ Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs
+ {{ }}
+ {{}}
+ Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs
+ {{ }}
+ {{ }}
+
+ {{}}
+ {{}}
+ Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack
+ {{ }}
+ {{ }}
+
+ {{}}
+ {{}}
+ Dynamic app server that can run beside NGINX, NGINX Plus, or on its own
+ {{ }}
+ {{ }}
+{{ }}
\ No newline at end of file
diff --git a/content/agent/_index.md b/content/agent/_index.md
index 478ab4f4b..f850a86ee 100644
--- a/content/agent/_index.md
+++ b/content/agent/_index.md
@@ -35,12 +35,12 @@ configurations, collection and reporting of real-time NGINX performance and oper
{{}}
{{}}
- {{}}
+ {{}}
Learn everything you need to know about NGINX Agent
{{ }}
- {{}}
+ {{}}
Install NGINX Agent and run a mock control plane
{{ }}
{{ }}
@@ -48,11 +48,11 @@ configurations, collection and reporting of real-time NGINX performance and oper
{{}}
{{}}
- {{}}
+ {{}}
{{ }}
- {{}}
+ {{}}
{{ }}
- {{}}
+ {{}}
{{ }}
{{ }}
{{ }}
\ No newline at end of file
diff --git a/content/nginx-one/_index.md b/content/nginx-one/_index.md
index b17183e2b..415f293b9 100644
--- a/content/nginx-one/_index.md
+++ b/content/nginx-one/_index.md
@@ -22,7 +22,7 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
{{}}
{{}}
- {{}}
+ {{}}
Get up and running with NGINX One Console
{{ }}
{{ }}
@@ -31,14 +31,17 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
{{}}
{{}}
- {{}}
+ {{}}
Work with data plane keys, containers, and proxy servers
{{ }}
- {{}}
+ {{}}
Manage one instance or groups of instances. Monitor certificates. Set up metrics.
{{ }}
- {{}}
- Set up security policies by instance and group
+ {{}}
+ Assign responsibilities with role-based access control
+ {{ }}
+ {{}}
+ Manage your NGINX fleet over REST
{{ }}
{{}}
Monitor deployments for CVEs and certificates
@@ -50,19 +53,10 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
{{}}
{{}}
- {{}}
- Monitor deployments for CVEs and certificates
- {{}}
- {{}}
- Assign responsibilities with role-based access control
- {{ }}
- {{}}
- Manage your NGINX fleet over REST
- {{ }}
- {{}}
+ {{}}
See latest updates: New features, improvements, and bug fixes
{{ }}
- {{}}
+ {{}}
See latest updates: New features, improvements, and bug fixes
{{ }}
{{ }}
@@ -73,31 +67,31 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
{{}}
{{< card-section title="Kubernetes Solutions">}}
- {{< card title="NGINX Ingress Controller" titleUrl="/nginx-ingress-controller/" brandIcon="NGINX-Ingress-Controller-product-icon.png">}}
+ {{< card title="NGINX Ingress Controller" titleUrl="/nginx-ingress-controller/" brandIcon="NGINX-Ingress-Controller-product-icon.svg">}}
Kubernetes traffic management with API gateway, identity, and observability features.
{{}}
- {{< card title="NGINX Gateway Fabric" titleUrl="/nginx-gateway-fabric" brandIcon="NGINX-product-icon.png">}}
+ {{< card title="NGINX Gateway Fabric" titleUrl="/nginx-gateway-fabric/" brandIcon="NGINX-product-icon.svg">}}
Next generation Kubernetes connectivity using the Gateway API.
{{}}
{{}}
{{< card-section title="Local Console Option">}}
- {{< card title="NGINX Instance Manager" titleUrl="/nginx-instance-manager" brandIcon="NGINX-Instance-Manager-product-icon.png">}}
+ {{< card title="NGINX Instance Manager" titleUrl="/nginx-instance-manager/" brandIcon="NGINX-Instance-Manager-product-icon.svg">}}
Track and control NGINX Open Source and NGINX Plus instances.
{{}}
{{}}
{{< card-section title="Modern App Delivery">}}
- {{< card title="NGINX Plus" titleUrl="/nginx" brandIcon="NGINX-Plus-product-icon-RGB.png">}}
+ {{< card title="NGINX Plus" titleUrl="/nginx/" brandIcon="NGINX-Plus-product-icon-RGB.svg">}}
The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
{{}}
- {{< card title="NGINX Open Source" titleUrl="https://nginx.org" brandIcon="NGINX-product-icon.png">}}
+ {{< card title="NGINX Open Source" titleUrl="https://nginx.org" brandIcon="NGINX-product-icon.svg">}}
The open source all-in-one load balancer, content cache, and web server
{{}}
{{}}
{{< card-section title="Security">}}
- {{< card title="NGINX App Protect WAF" titleUrl="/nginx-app-protect-waf" brandIcon="NGINX-App-Protect-WAF-product-icon.png">}}
+ {{< card title="NGINX App Protect WAF" titleUrl="/nginx-app-protect-waf/" brandIcon="NGINX-App-Protect-WAF-product-icon.svg">}}
Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs.
{{}}
- {{< card title="NGINX App Protect DoS" titleUrl="/nginx-app-protect-dos" brandIcon="NGINX-App-Protect-DoS-product-icon.png">}}
+ {{< card title="NGINX App Protect DoS" titleUrl="/nginx-app-protect-dos/" brandIcon="NGINX-App-Protect-DoS-product-icon.svg">}}
Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs.
{{}}
{{}}
diff --git a/layouts/index.html b/layouts/index.html
index ffd91fb72..303e1dfad 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -1,536 +1,3 @@
{{ define "main" }}
-{{/* mf homepage */}}
-
-
-
-{{ end }}
+{{ partial "homepage.html" . }}
+{{end}}
From 7eccaab835ea578cb6995e02994a4056c6a89a4a Mon Sep 17 00:00:00 2001
From: Lam <150060045+lamATnginx@users.noreply.github.com>
Date: Tue, 15 Jul 2025 10:44:09 -0700
Subject: [PATCH 5/8] Refactored icon usage to use new shortcode (#801)
* feat: Rewrote main landing page to be in markdown + updated card shortcode usage
* Update card params correctly
* chore: Refactored icon usage to use new shortcode
* Removed brand icons
* Removed final few brand icons
---
.../install-upgrade/install-from-oss-repo.md | 14 ++++++-------
.../install-upgrade/install-from-plus-repo.md | 14 ++++++-------
.../agent/install-upgrade/uninstall.md | 14 ++++++-------
.../monitoring/live-activity-monitoring.md | 20 +++++++++----------
.../nginx-configuration-portal.md | 2 +-
content/nginxaas-azure/quickstart/geoip2.md | 2 +-
...y-nginx-instance-manager-docker-compose.md | 4 ++--
.../build-and-deploy.md | 2 +-
.../infrastructure-as-code/configuration.md | 2 +-
content/nim/deploy/vm-bare-metal/install.md | 4 ++--
.../add-license-disconnected-deployment.md | 2 +-
.../offline-install-guide-manual.md | 4 ++--
.../nim/disconnected/offline-install-guide.md | 2 +-
.../report-usage-disconnected-deployment.md | 2 +-
.../configure-forward-proxy.md | 2 +-
.../system-configuration/secure-traffic.md | 2 +-
.../installation/install-devportal-offline.md | 2 +-
content/nms/acm/how-to/install-acm-offline.md | 2 +-
18 files changed, 48 insertions(+), 48 deletions(-)
diff --git a/content/nginx-one/agent/install-upgrade/install-from-oss-repo.md b/content/nginx-one/agent/install-upgrade/install-from-oss-repo.md
index 92c993e00..a36e42aeb 100644
--- a/content/nginx-one/agent/install-upgrade/install-from-oss-repo.md
+++ b/content/nginx-one/agent/install-upgrade/install-from-oss-repo.md
@@ -30,7 +30,7 @@ up the `nginx-agent` packages repository. Afterward, you can install and update
NGINX Agent from the repository.
-
From a632f59d38c3093601c7aef9adc48c341fd4a1b1 Mon Sep 17 00:00:00 2001
From: Lam <150060045+lamATnginx@users.noreply.github.com>
Date: Tue, 15 Jul 2025 10:26:55 -0700
Subject: [PATCH 4/8] Rewrite main landing page to be in markdown + updated
card shortcode usage (#818)
feat: Rewrote main landing page to be in markdown + updated card shortcode usage
---
content/_index.md | 55 +++-
content/agent/_index.md | 10 +-
content/nginx-one/_index.md | 40 ++-
layouts/index.html | 537 +-----------------------------------
4 files changed, 78 insertions(+), 564 deletions(-)
diff --git a/content/_index.md b/content/_index.md
index d6816edad..8370b5f87 100644
--- a/content/_index.md
+++ b/content/_index.md
@@ -1,4 +1,57 @@
---
title: NGINX Product Documentation
description: Learn how to deliver, manage, and protect your applications using F5 NGINX products.
----
\ No newline at end of file
+---
+
+## NGINX Product Documentation
+Learn how to deliver, manage, and protect your applications using F5 NGINX products.
+
+{{
-
-
-
-
- NGINX Unit
-
+
+
+
-
- {{ block "header" . }}{{end}}
-
-
-
-
-
-
-
-
-
-
-
- NGINX Product Documentation
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Instance Manager
-
-
- Track and control NGINX Open Source and NGINX Plus instances.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Ingress Controller
-
-
- Kubernetes traffic management with API gateway, identity, and observability features
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Gateway Fabric
-
-
- Next generation Kubernetes connectivity using the Gateway API.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Open Source
-
-
- The open source all-in-one load balancer, content cache, and web server
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Agent
-
-
- A daemon providing observability data and remote configuration for NGINX Open Source and NGINX Plus instances
-
-
-
-
-
-
-
-
-
-
-
-
- Subscription Licensing & Solutions
-
-
- Stay compliant with your NGINX subscription licenses and see how you can use NGINX One to build secure, scalable, and high-performing applications and APIs.
-
-
-
-
-
- NGINX App Protect
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX App Protect WAF
-
-
- Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs
-
-
-
-
-
-
-
-
-
-
-
- NGINX App Protect DoS
-
-
- Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs
-
-
-
-
-
-
- NGINX as a Service
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX as a Service for Azure
-
-
- Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack
-
-
-
-
-
- More NGINX Products
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - NGINX One Console -
-
- Monitor your infrastructure, address security vulnerabilities, and assess the health of your NGINX fleet, all from a single console.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Plus
-
-
- The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Instance Manager
-
-
- Track and control NGINX Open Source and NGINX Plus instances.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Ingress Controller
-
-
- Kubernetes traffic management with API gateway, identity, and observability features
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Gateway Fabric
-
-
- Next generation Kubernetes connectivity using the Gateway API.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Open Source
-
-
- The open source all-in-one load balancer, content cache, and web server
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Agent
-
-
- A daemon providing observability data and remote configuration for NGINX Open Source and NGINX Plus instances
-
-
-
-
-
-
-
-
-
-
-
-
- Subscription Licensing & Solutions
-
-
- Stay compliant with your NGINX subscription licenses and see how you can use NGINX One to build secure, scalable, and high-performing applications and APIs.
-
- - NGINX One -
- -
-
-
-
-
-
-
-
-
-
-
- - NGINX One Console -
-
- Monitor your infrastructure, address security vulnerabilities, and assess the health of your NGINX fleet, all from a single console.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Plus
-
-
- The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Instance Manager
-
-
- Track and control NGINX Open Source and NGINX Plus instances.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Ingress Controller
-
-
- Kubernetes traffic management with API gateway, identity, and observability features
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Gateway Fabric
-
-
- Next generation Kubernetes connectivity using the Gateway API.
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Open Source
-
-
- The open source all-in-one load balancer, content cache, and web server
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Agent
-
-
- A daemon providing observability data and remote configuration for NGINX Open Source and NGINX Plus instances
-
-
-
-
-
-
-
-
-
-
-
-
- Subscription Licensing & Solutions
-
-
- Stay compliant with your NGINX subscription licenses and see how you can use NGINX One to build secure, scalable, and high-performing applications and APIs.
-
-
-
-
-
- NGINX App Protect
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX App Protect WAF
-
-
- Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs
-
-
-
-
-
-
-
-
-
-
-
- NGINX App Protect DoS
-
-
- Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs
-
-
-
-
-
-
- NGINX as a Service
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX as a Service for Azure
-
-
- Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack
-
-
-
-
- More NGINX Products
-
-
-
-
-
-
-
-
-
-
-
-
-
- NGINX Unit
-
-
- Dynamic app server that can run beside NGINX, NGINX Plus, or on its own
-
-
-
{{< icon "brands fa-centos" >}} Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
+Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux @@ -39,7 +39,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-ubuntu" >}} Install NGINX Agent on Ubuntu
+Install NGINX Agent on Ubuntu
### Install NGINX Agent on Ubuntu @@ -48,7 +48,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-debian" >}} Install NGINX Agent on Debian
+Install NGINX Agent on Debian
### Install NGINX Agent on Debian @@ -57,7 +57,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-suse" >}} Install NGINX Agent on SLES
+Install NGINX Agent on SLES
### Install NGINX Agent on SLES @@ -66,7 +66,7 @@ NGINX Agent from the repository.
-
{{< icon "solid fa-mountain-sun" >}} Install NGINX Agent on Alpine Linux
+Install NGINX Agent on Alpine Linux
### Install NGINX Agent on Alpine Linux @@ -75,7 +75,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-aws" >}} Install NGINX Agent on Amazon Linux
+Install NGINX Agent on Amazon Linux
### Install NGINX Agent on Amazon Linux @@ -83,7 +83,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-freebsd" >}} Install NGINX Agent on FreeBSD
+Install NGINX Agent on FreeBSD
### Install NGINX Agent on FreeBSD diff --git a/content/nginx-one/agent/install-upgrade/install-from-plus-repo.md b/content/nginx-one/agent/install-upgrade/install-from-plus-repo.md index 64d4a92e3..85acd8e9d 100644 --- a/content/nginx-one/agent/install-upgrade/install-from-plus-repo.md +++ b/content/nginx-one/agent/install-upgrade/install-from-plus-repo.md @@ -31,7 +31,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-centos" >}} Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
+Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux @@ -40,7 +40,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-ubuntu" >}} Install NGINX Agent on Ubuntu
+Install NGINX Agent on Ubuntu
### Install NGINX Agent on Ubuntu @@ -49,7 +49,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-debian" >}} Install NGINX Agent on Debian
+Install NGINX Agent on Debian
### Install NGINX Agent on Debian @@ -58,7 +58,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-suse" >}} Install NGINX Agent on SLES
+Install NGINX Agent on SLES
### Install NGINX Agent on SLES @@ -67,7 +67,7 @@ NGINX Agent from the repository.
-
{{< icon "solid fa-mountain-sun" >}} Install NGINX Agent on Alpine Linux
+Install NGINX Agent on Alpine Linux
### Install NGINX Agent on Alpine Linux @@ -75,7 +75,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-aws" >}} Install NGINX Agent on Amazon Linux
+Install NGINX Agent on Amazon Linux
### Install NGINX Agent on Amazon Linux @@ -84,7 +84,7 @@ NGINX Agent from the repository.
-
{{< icon "brands fa-freebsd" >}} Install NGINX Agent on FreeBSD
+Install NGINX Agent on FreeBSD
### Install NGINX Agent on FreeBSD diff --git a/content/nginx-one/agent/install-upgrade/uninstall.md b/content/nginx-one/agent/install-upgrade/uninstall.md index 4010c5a67..6f16d9791 100644 --- a/content/nginx-one/agent/install-upgrade/uninstall.md +++ b/content/nginx-one/agent/install-upgrade/uninstall.md @@ -19,7 +19,7 @@ The user following performing the uninstall steps needs to have `root` privilege Complete the following steps on each host where you've installed NGINX Agent
-
{{< icon "brands fa-centos" >}} Uninstall NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
+Uninstall NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
### Uninstall NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux @@ -28,7 +28,7 @@ Complete the following steps on each host where you've installed NGINX Agent
-
{{< icon "brands fa-ubuntu" >}} Uninstall NGINX Agent on Ubuntu
+Uninstall NGINX Agent on Ubuntu
### Uninstall NGINX Agent on Ubuntu @@ -37,7 +37,7 @@ Complete the following steps on each host where you've installed NGINX Agent
-
{{< icon "brands fa-debian" >}} Uninstall NGINX Agent on Debian
+Uninstall NGINX Agent on Debian
### Uninstall NGINX Agent on Debian @@ -46,7 +46,7 @@ Complete the following steps on each host where you've installed NGINX Agent
-
{{< icon "brands fa-suse" >}} Uninstall NGINX Agent on SLES
+Uninstall NGINX Agent on SLES
### Uninstall NGINX Agent on SLES @@ -55,7 +55,7 @@ Complete the following steps on each host where you've installed NGINX Agent
-
{{< icon "solid fa-mountain-sun" >}} Uninstall NGINX Agent on Alpine Linux
+Uninstall NGINX Agent on Alpine Linux
### Uninstall NGINX Agent on Alpine Linux @@ -64,7 +64,7 @@ Complete the following steps on each host where you've installed NGINX Agent
-
{{< icon "brands fa-aws" >}} Uninstall NGINX Agent on Amazon Linux
+Uninstall NGINX Agent on Amazon Linux
### Uninstall NGINX Agent on Amazon Linux @@ -73,7 +73,7 @@ Complete the following steps on each host where you've installed NGINX Agent
-}}OpenAPI v2](/nginx/admin-guide/yaml/v9/nginx_api.yaml) for API version 9 | NGINX Plus Releases [33]({{< ref "/nginx/releases.md#r33" >}}), [34]({{< ref "nginx/releases.md#r34" >}})| The [`/license`](https://nginx.org/en/docs/http/ngx_http_api_module.html#license) data were added|
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v9/nginx_api.yaml) for API version 9 | NGINX Plus Releases [30]({{< ref "nginx/releases.md#r30" >}}), [31]({{< ref "nginx/releases.md#r31" >}}), [32]({{< ref "nginx/releases.md#r32" >}}) | The [`/workers/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#workers_) data were added|
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v8/nginx_api.yaml) for API version 8 | NGINX Plus Releases [27]({{< ref "nginx/releases.md#r27" >}}), [28]({{< ref "nginx/releases.md#r28" >}}), [29]({{< ref "nginx/releases.md#r29" >}}) | SSL statistics for each HTTP [upstream](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_upstream) and stream [upstream](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_stream_upstream), SSL statistics for each HTTP [server zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_server_zone) and stream [server zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_stream_server_zone), extended statistics for [SSL](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_ssl_object) endpoint|
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v7/nginx_api.yaml) for API version 7 | NGINX Plus Releases [25]({{< ref "nginx/releases.md#r25" >}}), [26]({{< ref "nginx/releases.md#r26" >}}),| The `codes` data in `responses` for each HTTP [upstream](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_upstream), [server zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_server_zone), and [location zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_location_zone) were added|
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v6/nginx_api.yaml) for API version 6 | NGINX Plus Releases [20]({{< ref "nginx/releases.md#r20" >}}), [21]({{< ref "nginx/releases.md#r21" >}}), [22]({{< ref "nginx/releases.md#r22" >}}), [23]({{< ref "nginx/releases.md#r23" >}}), [24]({{< ref "nginx/releases.md#r24" >}}) | The [`/stream/limit_conns/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#stream_limit_conns_), [`/http/limit_conns/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#http_limit_conns_), and [`/http/limit_reqs/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#http_limit_reqs_) data were added |
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v5/nginx_api.yaml) for API version 5 | NGINX Plus Release [19]({{< ref "nginx/releases.md#r19" >}}) | The `expire` parameter of a [key-value](https://nginx.org/en/docs/http/ngx_http_keyval_module.html) pair can be [set](https://nginx.org/en/docs/http/ngx_http_api_module.html#postHttpKeyvalZoneData) or [changed](https://nginx.org/en/docs/http/ngx_http_api_module.html#patchHttpKeyvalZoneKeyValue), the [`/resolvers/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#resolvers_) and [`/http/location_zones/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#http_location_zones_) data were added |
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v4/nginx_api.yaml) for API version 4 | NGINX Plus Release [18]({{< ref "nginx/releases.md#r18" >}}) | The `path` and `method` fields of [nginx error object](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_error) were removed. These fields continue to exist in earlier api versions, but show an empty value |
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v3/nginx_api.yaml) for API version 3 | NGINX Plus Releases [15]({{< ref "nginx/releases.md#r15" >}}), [16]({{< ref "nginx/releases.md#r16" >}}), [17]({{< ref "nginx/releases.md#r17" >}}) | The [`/stream/zone_sync/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#stream_zone_sync_) data were added |
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v2/nginx_api.yaml) for API version 2 | NGINX Plus Release [14]({{< ref "nginx/releases.md#r14" >}}) | The [`drain`](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_upstream_conf_server) parameter was added |
+|[{{}}OpenAPI v2](/nginx/admin-guide/yaml/v1/nginx_api.yaml) for API version 1 | NGINX Plus Release [13]({{< ref "nginx/releases.md#r13" >}})| The [`/stream/keyvals/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#stream_keyvals_) data were added |
{{}}
diff --git a/content/nginxaas-azure/getting-started/nginx-configuration/nginx-configuration-portal.md b/content/nginxaas-azure/getting-started/nginx-configuration/nginx-configuration-portal.md
index 50a94a887..ef07b74aa 100644
--- a/content/nginxaas-azure/getting-started/nginx-configuration/nginx-configuration-portal.md
+++ b/content/nginxaas-azure/getting-started/nginx-configuration/nginx-configuration-portal.md
@@ -39,7 +39,7 @@ NGINXaaS supports Layer 7 HTTP loadbalancing. To configure .com and .net servers
| -------- | ----------- |
| File path | Each NGINX configuration file can be uniquely identified by a file path (for example, nginx.conf or /etc/nginx/nginx.conf) to align with the intended NGINX configuration file structure. |
| Root file | The root file is the main NGINX configuration file.}}If specifying an absolute file path, see the [NGINX Filesystem Restrictions table]({{< ref "/nginxaas-azure/getting-started/nginx-configuration/overview/#nginx-filesystem-restrictions" >}}) for the allowed directories the file can be written to.{{ }}
diff --git a/content/nginxaas-azure/quickstart/geoip2.md b/content/nginxaas-azure/quickstart/geoip2.md
index dbdc27134..e764cd0f9 100644
--- a/content/nginxaas-azure/quickstart/geoip2.md
+++ b/content/nginxaas-azure/quickstart/geoip2.md
@@ -18,7 +18,7 @@ NGINXaaS uses your MaxMind license to download GeoIP2 databases, puts them in th
To enable GeoIP2 you [update your NGINX configuration]({{< ref "/nginxaas-azure/getting-started/nginx-configuration/overview.md">}}) to include your MaxMind license and the relevant NGINX directives.
1. Log into MaxMind and [generate a `GeoIP.conf`](https://dev.maxmind.com/geoip/updating-databases/#2-obtain-geoipconf-with-account-information) file.
-2. Add the `GeoIP.conf` file to your NGINX configuration, using the exact path `/etc/nginx/GeoIP.conf`. The `GeoIP.conf` will be validated, and must include `AccountID`, `LicenseKey`, and `EditionIDs`. Other configuration options in `GeoIP.conf` are ignored. We recommend you enable the **Protected** {{< icon "solid fa-toggle-on">}} toggle button to mark `GeoIP.conf` as a protected file, which will prevent the contents from being read via any Azure client tools.
+2. Add the `GeoIP.conf` file to your NGINX configuration, using the exact path `/etc/nginx/GeoIP.conf`. The `GeoIP.conf` will be validated, and must include `AccountID`, `LicenseKey`, and `EditionIDs`. Other configuration options in `GeoIP.conf` are ignored. We recommend you enable the **Protected** {{}} toggle button to mark `GeoIP.conf` as a protected file, which will prevent the contents from being read via any Azure client tools.
3. Add the `load_module` directive - the modules are available at `modules/ngx_http_geoip2_module.so` or `modules/ngx_stream_geoip2_module.so`.
4. Add `geoip2` directives to your NGINX configuration as desired. The `EditionIDs` from your `GeoIP.conf` are available at `/usr/local/share/GeoIP`
diff --git a/content/nim/deploy/docker/deploy-nginx-instance-manager-docker-compose.md b/content/nim/deploy/docker/deploy-nginx-instance-manager-docker-compose.md
index dd37fa944..b1f9523bb 100644
--- a/content/nim/deploy/docker/deploy-nginx-instance-manager-docker-compose.md
+++ b/content/nim/deploy/docker/deploy-nginx-instance-manager-docker-compose.md
@@ -31,9 +31,9 @@ Before you begin, make sure you have the following:
- A JSON Web Token (JWT) from your [MyF5 subscriptions page](https://my.f5.com/manage/s/subscriptions). This is the same token used for NGINX Plus.
- The right `docker-compose.yaml` file for your setup:
- For **standard mode** (with metrics and dashboards):
- {{< icon "download">}} {{}}
+ {{}} {{}}
- For **lightweight mode** (no ClickHouse, no metrics):
- {{< icon "download">}} {{}}
+ {{}} {{}}
{{< note >}} If you're not sure which one to use, start with lightweight mode. You can always switch later by changing the Compose file and setting `ENABLE_METRICS: "true"`.{{< /note >}}
diff --git a/content/nim/deploy/infrastructure-as-code/build-and-deploy.md b/content/nim/deploy/infrastructure-as-code/build-and-deploy.md
index f54fc9dbd..aed40e279 100644
--- a/content/nim/deploy/infrastructure-as-code/build-and-deploy.md
+++ b/content/nim/deploy/infrastructure-as-code/build-and-deploy.md
@@ -18,7 +18,7 @@ The deployment process has two stages:
- Generate an image using Packer.
- Deploy the image using Terraform.
-{{< call-out "tip" "Open-Source Project on GitHub" "fa-brands fa-github" >}}
+{{< call-out "tip" "Open-Source Project on GitHub" >}}
The steps in this guide refer to the [NGINX Instance Manager Infrastructure as Code (IAC)](https://github.com/nginxinc/nginx-management-suite-iac) project on GitHub.
{{< /call-out >}}
diff --git a/content/nim/deploy/infrastructure-as-code/configuration.md b/content/nim/deploy/infrastructure-as-code/configuration.md
index 51c43dee3..481a7d30b 100644
--- a/content/nim/deploy/infrastructure-as-code/configuration.md
+++ b/content/nim/deploy/infrastructure-as-code/configuration.md
@@ -15,7 +15,7 @@ This guide explains how to install F5 NGINX Instance Manager using the open-sour
With Ansible, you can automate and replicate your installation across multiple environments.
-{{< call-out "tip" "Open-Source Project on GitHub" "fa-brands fa-github" >}}
+{{< call-out "tip" "Open-Source Project on GitHub" >}}
The steps in this guide refer to the [Ansible NGINX Instance Manager Role](https://github.com/nginxinc/ansible-role-nginx-management-suite) project on GitHub.
{{< /call-out >}}
diff --git a/content/nim/deploy/vm-bare-metal/install.md b/content/nim/deploy/vm-bare-metal/install.md
index 5519f8104..f06b29897 100644
--- a/content/nim/deploy/vm-bare-metal/install.md
+++ b/content/nim/deploy/vm-bare-metal/install.md
@@ -30,7 +30,7 @@ Follow these steps to prepare for installing NGINX Instance Manager:
- **Download the installation script**:
- {{< icon "download">}} {{}}
+ {{}} {{}}
- **Download the certificate and private key** (see the steps [below](#download-cert-key)):
Use the certificate and private key for NGINX Instance Manager (the same files used for NGINX Plus).
@@ -91,7 +91,7 @@ Download the certificate and private key required for NGINX Instance Manager. Th
If you haven’t already downloaded the script, you can download it here:
-{{< icon "download">}} {{}}
+{{}} {{}}
### Prepare your system for installation
diff --git a/content/nim/disconnected/add-license-disconnected-deployment.md b/content/nim/disconnected/add-license-disconnected-deployment.md
index e40b43b86..e1ec9fb32 100644
--- a/content/nim/disconnected/add-license-disconnected-deployment.md
+++ b/content/nim/disconnected/add-license-disconnected-deployment.md
@@ -51,7 +51,7 @@ To add a license and submit the initial usage report in a disconnected environme
-1. {{< icon "download">}}[Download license_usage_offline.sh](/scripts/license_usage_offline.sh). +1. {{}}[Download license_usage_offline.sh](/scripts/license_usage_offline.sh).
1. Run the following command to allow the script to run:
```bash
diff --git a/content/nim/disconnected/offline-install-guide-manual.md b/content/nim/disconnected/offline-install-guide-manual.md
index 0c851f509..6cc81f7f6 100644
--- a/content/nim/disconnected/offline-install-guide-manual.md
+++ b/content/nim/disconnected/offline-install-guide-manual.md
@@ -35,7 +35,7 @@ To complete the steps in this guide, you need to download the NGINX Instance Man
Local dependencies are common Linux packages like `curl` or `openssl`, which most Linux distributions include by default. When installing NGINX Instance Manager, your package manager will automatically install these dependencies. Without internet access, ensure your package manager can use a local package repository, such as a distribution DVD/ISO image or internal network mirror. Check your Linux distribution's documentation for details.
-{{< call-out "note" "RedHat on AWS" "fa-brands fa-aws" >}}If you're using AWS and can't attach remote or local RedHat package repositories, download the necessary packages on another RedHat machine and copy them to your target machine. Use the `yumdownloader` utility for this task:
+{{< call-out "note" "RedHat on AWS" >}}If you're using AWS and can't attach remote or local RedHat package repositories, download the necessary packages on another RedHat machine and copy them to your target machine. Use the `yumdownloader` utility for this task:
.
{{}}
@@ -47,7 +47,7 @@ To download external dependencies:
1. Download the `fetch-external-dependencies.sh` script:
- {{< icon "download">}} {{}}
+ {{}} {{}}
2. Run the script to download the external dependencies for your specific Linux distribution:
diff --git a/content/nim/disconnected/offline-install-guide.md b/content/nim/disconnected/offline-install-guide.md
index 3da69a4e7..5dd212173 100644
--- a/content/nim/disconnected/offline-install-guide.md
+++ b/content/nim/disconnected/offline-install-guide.md
@@ -62,7 +62,7 @@ Download the SSL certificate and private key required for NGINX Instance Manager
### Download the installation script
-{{< icon "download">}} {{}}
+{{}} {{}}
## Package NGINX Instance Manager and dependencies for offline installation
diff --git a/content/nim/disconnected/report-usage-disconnected-deployment.md b/content/nim/disconnected/report-usage-disconnected-deployment.md
index 4a4d5c14c..a3913a058 100644
--- a/content/nim/disconnected/report-usage-disconnected-deployment.md
+++ b/content/nim/disconnected/report-usage-disconnected-deployment.md
@@ -47,7 +47,7 @@ To submit a usage report in a disconnected environment, use the provided `licens
-1. {{< icon "download">}}[Download license_usage_offline.sh](/scripts/license_usage_offline.sh). +1. {{}}[Download license_usage_offline.sh](/scripts/license_usage_offline.sh).
1. Run the following command to allow the script to run:
```bash
diff --git a/content/nim/system-configuration/configure-forward-proxy.md b/content/nim/system-configuration/configure-forward-proxy.md
index 7e071047b..51746e52f 100644
--- a/content/nim/system-configuration/configure-forward-proxy.md
+++ b/content/nim/system-configuration/configure-forward-proxy.md
@@ -127,7 +127,7 @@ kubectl edit cm nms-conf -n
If you’re deploying NGINX Instance Manager with Docker Compose, update the `docker-compose.yaml` file to configure a forward proxy.
1. **Before you begin**: Follow the [Docker Compose deployment guide]({{< ref "nim/deploy/docker/deploy-nginx-instance-manager-docker-compose.md" >}}) to set up Docker for the NGINX container registry. The deployment guide also covers additional environment variables you may want to consider before deployment.
-2. {{< icon "download">}} {{}}
+2. {{}} {{}}
3. Update `docker-compose.yaml` with the proxy settings:
Modify the `services.nim.environment` section to include the proxy configuration:
diff --git a/content/nim/system-configuration/secure-traffic.md b/content/nim/system-configuration/secure-traffic.md
index 8ad45571e..5a95b9905 100644
--- a/content/nim/system-configuration/secure-traffic.md
+++ b/content/nim/system-configuration/secure-traffic.md
@@ -194,7 +194,7 @@ To generate the necessary certificates, follow these steps. You can modify these
}} {{}}
``` yaml
[req]
diff --git a/content/nms/acm/how-to/devportals/installation/install-devportal-offline.md b/content/nms/acm/how-to/devportals/installation/install-devportal-offline.md
index 4744645b9..899d8dcd9 100644
--- a/content/nms/acm/how-to/devportals/installation/install-devportal-offline.md
+++ b/content/nms/acm/how-to/devportals/installation/install-devportal-offline.md
@@ -34,7 +34,7 @@ To install NGINX Plus and njs, take the following steps on the Developer Portal
3. Select the following link to download the `fetch-external-acm-dataplane-dependencies.sh` script. This script downloads the necessary NGINX Plus and njs packages to a `tar.gz` archive.
- {{< icon "download">}} {{}}
+ {{}} {{}}
4. To download the NGINX Plus and njs dependencies, run the `fetch-external-acm-dataplane-dependencies.sh` script. As parameters, specify your Linux distribution and the location of your `nginx-repo.crt` and `nginx-repo.key` files.
diff --git a/content/nms/acm/how-to/install-acm-offline.md b/content/nms/acm/how-to/install-acm-offline.md
index b449e669d..74189e448 100644
--- a/content/nms/acm/how-to/install-acm-offline.md
+++ b/content/nms/acm/how-to/install-acm-offline.md
@@ -152,7 +152,7 @@ The API Connectivity Manager data plane requires [NGINX Plus R24](https://docs.n
3. Select the following link to download the `fetch-external-acm-dataplane-dependencies.sh` script. This script downloads the necessary NGINX Plus and njs packages to a `tar.gz` archive.
- {{< icon "download">}} {{}}
+ {{}} {{}}
4. To download the NGINX Plus and njs dependencies, run the `fetch-external-acm-dataplane-dependencies.sh` script. As parameters, specify your Linux distribution and the location of your `nginx-repo.crt` and `nginx-repo.key` files.
From 9e59706c162398957b6a6a2452cc5d1523edd097 Mon Sep 17 00:00:00 2001
From: Jack Hickey <133868041+nginx-jack@users.noreply.github.com>
Date: Fri, 18 Jul 2025 13:50:29 +0100
Subject: [PATCH 6/8] Add overview of nginx-org source ingestion
---
documentation/nginx-org-source.md | 45 +++++++++++++++++++++++++++++++
1 file changed, 45 insertions(+)
create mode 100644 documentation/nginx-org-source.md
diff --git a/documentation/nginx-org-source.md b/documentation/nginx-org-source.md
new file mode 100644
index 000000000..e7e9bbd28
--- /dev/null
+++ b/documentation/nginx-org-source.md
@@ -0,0 +1,45 @@
+# nginx.org content
+
+This document describes the process by which https://github.com/nginx/nginx.org are ingested by the `nginx/documentation` repository, and rendered as markdown.
+
+## Source of truth
+The https://github.com/nginx/nginx.org repository remains the source of truth for a subset of content in `/content/nginx`. Primarily, this includes is the `module reference`, and the https://github.com/nginx/nginx.org/blob/main/yaml/nginx_api.yaml.
+
+Any modifications to these autogenerated files will be blocked during the pull request process.
+If modifications are required, they will be made in the source xml in https://github.com/nginx/nginx.org repository.
+
+All files that are autogenerated from this source, will have the warning:
+
+```md
+********************************************************************************
+🛑 WARNING: AUTOGENERATED FILE - DO NOT EDIT 🛑 This Markdown file was
+automatically generated from the source XML documentation. Any manual
+changes made directly to this file will be overwritten. To request or
+suggest changes, please edit the source XML files instead.
+https://github.com/nginx/nginx.org/tree/main/xml/en
+********************************************************************************
+```
+
+## Markdown generation flow
+
+A GitHub Action running as a cron job in the `nginx/documentation` repository detects changes in the documentation within `nginx/nginx.org`, generates new markdown files when changes are found, and creates a PR with these changes.
+
+Only PRs generated by this GitHub Action can be merged.
+
+The markdown files are generated using a markdown-specific XSLT file, which targets only the XML sources intended for inclusion in the nginx/documentation repository.
+
+```mermaid
+flowchart TD
+ Start([Cron Job Triggered]) --> CheckChanges{Changes detected in 'en' docs of nginx/nginx.org?}
+ CheckChanges -- Yes --> CloneRepo[Clone nginx/nginx.org repository]
+ CloneRepo --> RunMake["Execute make target: 'make hugo-md'"]
+ RunMake --> MoveFiles["Move generated markdown files to '/content/nginx' directory"]
+ MoveFiles --> OpenPR["Create PR in nginx/documentation repository"]
+ OpenPR --> Finish([End])
+
+ CheckChanges -- No --> FinishNoAction([End - No updates detected])
+
+ style Finish stroke:#27ae60,stroke-width:2px
+ style OpenPR stroke:#2980b9,stroke-width:2px
+ style CheckChanges stroke:#7f8c8d,stroke-width:2px
+```
From a158c5af555334c4616b40ae94470d46f49311c5 Mon Sep 17 00:00:00 2001
From: Lam Nguyen
Date: Thu, 24 Jul 2025 12:29:31 -0700
Subject: [PATCH 7/8] Update N1 landing page to use updated params
---
content/nginx-one/_index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/content/nginx-one/_index.md b/content/nginx-one/_index.md
index 415f293b9..2a626d7ce 100644
--- a/content/nginx-one/_index.md
+++ b/content/nginx-one/_index.md
@@ -22,7 +22,7 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
{{}}
{{}}
- {{}}
+ {{}}
Get up and running with NGINX One Console
{{ }}
{{ }}
From 606cd766f483906c0cc56ed9e50b0715fff62e68 Mon Sep 17 00:00:00 2001
From: Lam Nguyen
Date: Mon, 28 Jul 2025 15:14:03 -0700
Subject: [PATCH 8/8] chore: Cleaned up landing pages
---
content/agent/_index.md | 9 +++----
content/nginx-one/_index.md | 47 ++++++++++++++++++-------------------
2 files changed, 26 insertions(+), 30 deletions(-)
diff --git a/content/agent/_index.md b/content/agent/_index.md
index f850a86ee..a8d47c414 100644
--- a/content/agent/_index.md
+++ b/content/agent/_index.md
@@ -48,11 +48,8 @@ configurations, collection and reporting of real-time NGINX performance and oper
{{}}
{{}}
- {{}}
- {{ }}
- {{}}
- {{ }}
- {{}}
- {{ }}
+ {{ }}
{{ }}
\ No newline at end of file
diff --git a/content/nginx-one/_index.md b/content/nginx-one/_index.md
index 2a626d7ce..a45605081 100644
--- a/content/nginx-one/_index.md
+++ b/content/nginx-one/_index.md
@@ -28,7 +28,6 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
{{}}
{{ }}
-
{{}}
{{}}
{{}}
@@ -45,7 +44,7 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
{{ }}
{{}}
Monitor deployments for CVEs and certificates
- {{}}
+ {{ }}
{{ }}
{{ }}
@@ -66,33 +65,33 @@ F5 NGINX One Console makes it easy to manage NGINX instances across locations an
[//]: # "You can add any extra content for the page here, such as additional cards, diagrams or text."
{{}}
- {{< card-section title="Kubernetes Solutions">}}
- {{< card title="NGINX Ingress Controller" titleUrl="/nginx-ingress-controller/" brandIcon="NGINX-Ingress-Controller-product-icon.svg">}}
+ {{}}
+ {{}}
Kubernetes traffic management with API gateway, identity, and observability features.
- {{}}
- {{< card title="NGINX Gateway Fabric" titleUrl="/nginx-gateway-fabric/" brandIcon="NGINX-product-icon.svg">}}
+ {{ }}
+ {{}}
Next generation Kubernetes connectivity using the Gateway API.
- {{}}
- {{}}
- {{< card-section title="Local Console Option">}}
- {{< card title="NGINX Instance Manager" titleUrl="/nginx-instance-manager/" brandIcon="NGINX-Instance-Manager-product-icon.svg">}}
+ {{ }}
+ {{ }}
+ {{}}
+ {{}}
Track and control NGINX Open Source and NGINX Plus instances.
- {{}}
- {{}}
- {{< card-section title="Modern App Delivery">}}
- {{< card title="NGINX Plus" titleUrl="/nginx/" brandIcon="NGINX-Plus-product-icon-RGB.svg">}}
+ {{ }}
+ {{ }}
+ {{}}
+ {{}}
The all-in-one load balancer, reverse proxy, web server, content cache, and API gateway.
- {{}}
- {{< card title="NGINX Open Source" titleUrl="https://nginx.org" brandIcon="NGINX-product-icon.svg">}}
+ {{ }}
+ {{}}
The open source all-in-one load balancer, content cache, and web server
- {{}}
- {{}}
- {{< card-section title="Security">}}
- {{< card title="NGINX App Protect WAF" titleUrl="/nginx-app-protect-waf/" brandIcon="NGINX-App-Protect-WAF-product-icon.svg">}}
+ {{ }}
+ {{ }}
+ {{}}
+ {{}}
Lightweight, high-performance, advanced protection against Layer 7 attacks on your apps and APIs.
- {{}}
- {{< card title="NGINX App Protect DoS" titleUrl="/nginx-app-protect-dos/" brandIcon="NGINX-App-Protect-DoS-product-icon.svg">}}
+ {{ }}
+ {{}}
Defend, adapt, and mitigate against Layer 7 denial-of-service attacks on your apps and APIs.
- {{}}
- {{}}
+ {{ }}
+ {{ }}
{{ }}
{{< icon "brands fa-freebsd" >}} Uninstall NGINX Agent on FreeBSD
+Uninstall NGINX Agent on FreeBSD
### Uninstall NGINX Agent on FreeBSD diff --git a/content/nginx/admin-guide/monitoring/live-activity-monitoring.md b/content/nginx/admin-guide/monitoring/live-activity-monitoring.md index ce210e7fc..e1051af0c 100644 --- a/content/nginx/admin-guide/monitoring/live-activity-monitoring.md +++ b/content/nginx/admin-guide/monitoring/live-activity-monitoring.md @@ -521,16 +521,16 @@ To enable the Swagger UI: |OpenAPI YAML File/API Version | NGINX Plus Version | Changes | | ---| --- | --- | -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v9/nginx_api.yaml) for API version 9 | NGINX Plus Releases [33]({{< ref "/nginx/releases.md#r33" >}}), [34]({{< ref "nginx/releases.md#r34" >}})| The [`/license`](https://nginx.org/en/docs/http/ngx_http_api_module.html#license) data were added| -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v9/nginx_api.yaml) for API version 9 | NGINX Plus Releases [30]({{< ref "nginx/releases.md#r30" >}}), [31]({{< ref "nginx/releases.md#r31" >}}), [32]({{< ref "nginx/releases.md#r32" >}}) | The [`/workers/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#workers_) data were added| -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v8/nginx_api.yaml) for API version 8 | NGINX Plus Releases [27]({{< ref "nginx/releases.md#r27" >}}), [28]({{< ref "nginx/releases.md#r28" >}}), [29]({{< ref "nginx/releases.md#r29" >}}) | SSL statistics for each HTTP [upstream](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_upstream) and stream [upstream](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_stream_upstream), SSL statistics for each HTTP [server zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_server_zone) and stream [server zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_stream_server_zone), extended statistics for [SSL](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_ssl_object) endpoint| -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v7/nginx_api.yaml) for API version 7 | NGINX Plus Releases [25]({{< ref "nginx/releases.md#r25" >}}), [26]({{< ref "nginx/releases.md#r26" >}}),| The `codes` data in `responses` for each HTTP [upstream](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_upstream), [server zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_server_zone), and [location zone](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_location_zone) were added| -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v6/nginx_api.yaml) for API version 6 | NGINX Plus Releases [20]({{< ref "nginx/releases.md#r20" >}}), [21]({{< ref "nginx/releases.md#r21" >}}), [22]({{< ref "nginx/releases.md#r22" >}}), [23]({{< ref "nginx/releases.md#r23" >}}), [24]({{< ref "nginx/releases.md#r24" >}}) | The [`/stream/limit_conns/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#stream_limit_conns_), [`/http/limit_conns/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#http_limit_conns_), and [`/http/limit_reqs/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#http_limit_reqs_) data were added | -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v5/nginx_api.yaml) for API version 5 | NGINX Plus Release [19]({{< ref "nginx/releases.md#r19" >}}) | The `expire` parameter of a [key-value](https://nginx.org/en/docs/http/ngx_http_keyval_module.html) pair can be [set](https://nginx.org/en/docs/http/ngx_http_api_module.html#postHttpKeyvalZoneData) or [changed](https://nginx.org/en/docs/http/ngx_http_api_module.html#patchHttpKeyvalZoneKeyValue), the [`/resolvers/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#resolvers_) and [`/http/location_zones/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#http_location_zones_) data were added | -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v4/nginx_api.yaml) for API version 4 | NGINX Plus Release [18]({{< ref "nginx/releases.md#r18" >}}) | The `path` and `method` fields of [nginx error object](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_error) were removed. These fields continue to exist in earlier api versions, but show an empty value | -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v3/nginx_api.yaml) for API version 3 | NGINX Plus Releases [15]({{< ref "nginx/releases.md#r15" >}}), [16]({{< ref "nginx/releases.md#r16" >}}), [17]({{< ref "nginx/releases.md#r17" >}}) | The [`/stream/zone_sync/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#stream_zone_sync_) data were added | -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v2/nginx_api.yaml) for API version 2 | NGINX Plus Release [14]({{< ref "nginx/releases.md#r14" >}}) | The [`drain`](https://nginx.org/en/docs/http/ngx_http_api_module.html#def_nginx_http_upstream_conf_server) parameter was added | -|[{{< icon "download">}}OpenAPI v2](/nginx/admin-guide/yaml/v1/nginx_api.yaml) for API version 1 | NGINX Plus Release [13]({{< ref "nginx/releases.md#r13" >}})| The [`/stream/keyvals/`](https://nginx.org/en/docs/http/ngx_http_api_module.html#stream_keyvals_) data were added | +|[{{- The first file created will be the root file by default. You can designate a different root file if you have more than a single configuration file in your deployment.
- The root file is designated with a {{< golden-star >}} icon on the portal.
- To protect a file, enable the **Protected** {{< icon "solid fa-toggle-on">}} toggle button.
- You cannot access the file contents of a protected file saved to the NGINX configuration, but you can view its metadata, such as the SHA-256 hash of the file contents.
- You can provide new contents for an existing protected file using the **Overwrite** link or resubmit it without having to provide the file contents again.
- To modify the file path of a protected file or convert it to a regular file, delete the original file and create a new one.
- A protected file is designated with a {{< icon "solid fa-lock">}} icon on the portal.
- To protect a file, enable the **Protected** {{
}} toggle button. - You cannot access the file contents of a protected file saved to the NGINX configuration, but you can view its metadata, such as the SHA-256 hash of the file contents.
- You can provide new contents for an existing protected file using the **Overwrite** link or resubmit it without having to provide the file contents again.
- To modify the file path of a protected file or convert it to a regular file, delete the original file and create a new one.
- A protected file is designated with a {{
}} icon on the portal.
-1. {{< icon "download">}}[Download license_usage_offline.sh](/scripts/license_usage_offline.sh). +1. {{
-1. {{< icon "download">}}[Download license_usage_offline.sh](/scripts/license_usage_offline.sh). +1. {{