NGINX on Kubernetes
Your hub for NGINX's Kubernetes ecosystem — Ingress controllers, Gateway API implementations, migration tools, and conversion utilities.
Explore the ecosystem
NGINX Ingress Controller
Production-grade Ingress controller with advanced traffic management, VirtualServer CRDs, and full observability.
Best if you run Ingress resources today or are migrating from ingress-nginx.
ProjectNGINX Gateway Fabric
Gateway API implementation powered by NGINX with control and data plane separation for future-ready traffic management.
Best if you're adopting the Kubernetes Gateway API.
ToolIngress-NGINX to NGINX Ingress Controller Migration Tool
Interactive guide for migrating from the community Ingress-NGINX controller with 130+ annotation mappings and CRD examples.
Toolingress2gateway
CLI tool to convert Ingress resources to Gateway API resources using the NGINX provider.
Featured content
Featured video
Ingress-NGINX Is Retiring, NGINX Is Not
CNCF On-Demand webinar
Featured video
Cutting Through the Kubernetes Confusion
NGINX Ingress, Gateway Fabric, and What's Next
Featured blog
The NGINX Kubernetes Open Source Roadmap: First Half of 2026
What's coming next for NGINX Ingress Controller, NGINX Gateway Fabric, and the broader Kubernetes ecosystem.
Read on blog.nginx.org ›
Featured blog
NGINX Ingress Controller v5.4.0: Making Migration Easier Than Ever
New features designed to simplify migration from Ingress-NGINX, including CORS support, configuration validation, and expanded annotation compatibility.
Read on blog.nginx.org ›NGINX Ingress Controller
Production-grade Ingress controller built on NGINX. Advanced traffic management, TLS termination, VirtualServer CRDs, and full observability for Kubernetes.
Advanced traffic management
Load balancing, rate limiting, circuit breaking, and blue-green deployments with fine-grained control via annotations or VirtualServer CRDs.
SSL/TLS management
TLS termination, SSL passthrough, forced redirects, and certificate management via Kubernetes Secrets.
TCP/UDP load balancing
Layer 4 load balancing for non-HTTP workloads using TransportServer and GlobalConfiguration custom resources.
VirtualServer CRDs
VirtualServer, VirtualServerRoute, Policy, TransportServer, and GlobalConfiguration custom resources for advanced routing beyond Ingress.
Snippets & customization
Server, location, and HTTP snippets for injecting custom NGINX configuration. Full control without forking the controller.
Prometheus & OpenTelemetry
Built-in Prometheus metrics endpoint and OpenTelemetry tracing for full observability of your ingress traffic.
Compatibility
| Component | Version |
|---|---|
| Kubernetes | 1.34, 1.35, 1.36 |
| NGINX | 1.31.2 |
Quick start
# Install via Helm (OCI registry)
helm install nginx-ingress \
oci://ghcr.io/nginx/charts/nginx-ingress \
--version 2.6.1 \
--namespace nginx-ingress --create-namespaceNGINX Gateway Fabric
Gateway API implementation powered by NGINX. A future-ready, standards-based approach to Kubernetes traffic management with control and data plane separation.
Gateway API native
First-class Kubernetes Gateway API v1.5.1 implementation with full conformance testing across HTTP, GRPC, TLS, TCP, and UDP.
Control & data plane separation
Clean architectural split with NGINX Agent dynamically managing the NGINX data plane for reliability and scale.
Multi-cloud ready
Deploy consistently across hybrid and multi-cloud Kubernetes environments with portable Gateway API resources.
TLS & mTLS
Flexible TLS termination and passthrough with automatic certificate management and mutual TLS support.
Traffic splitting
Weighted backend routing for canary deployments and A/B testing using native HTTPRoute resources.
Extensibility
SnippetsFilter, ClientSettingsPolicy, and ObservabilityPolicy custom resources for use cases beyond core Gateway API.
Key details
Compatibility
| Component | Version |
|---|---|
| Kubernetes | 1.34, 1.35, 1.36 |
| NGINX | 1.31.2 |
Quick start
# Install via Helm (OCI registry)
helm install nginx-gateway-fabric \
oci://ghcr.io/nginx/charts/nginx-gateway-fabric \
--version 2.6.6 \
--namespace nginx-gateway-fabric --create-namespaceIngress-NGINX to NGINX Ingress Controller Migration Tool
Migrate from the community Ingress-NGINX controller to the NGINX Ingress Controller. Interactive YAML analysis, 130+ annotation mappings, and CRD migration examples.
Interactive YAML analyzer
Paste your existing Ingress YAML and get an instant migration plan with converted annotations, ConfigMap mappings, and CRD suggestions.
130+ annotation mappings
Complete mapping table with community annotations, their NGINX Ingress Controller equivalents, side-by-side YAML examples, and searchable filters.
CRD migration examples
Side-by-side examples for VirtualServer, VirtualServerRoute, Policy, TransportServer, and GlobalConfiguration CRDs.
ConfigMap migration
Detailed guide for migrating ConfigMap-based global configuration between the community controller and the NGINX Ingress Controller.
Complexity assessment
The analyzer evaluates your Ingress resources and provides a migration complexity score with actionable recommendations.
Copy-ready output
Every code block and generated YAML snippet includes a one-click copy button for immediate use in your workflow.
The migration tool is a static HTML application with first-party CSS/JS and no third-party runtime dependencies. It covers every annotation and ConfigMap key from the community controller.
ingress2gateway
Convert Ingress resources to Gateway API resources using the NGINX provider. Automate your migration from Ingress to the Kubernetes Gateway API.
Automated conversion
Reads Ingress resources from your cluster or YAML files and outputs equivalent Gateway API manifests automatically.
NGINX provider
Dedicated NGINX provider that understands 14 NGINX-specific annotations and converts them to their Gateway API equivalents.
Gateway & HTTPRoute output
Produces Gateway and HTTPRoute resources ready for direct application to your cluster.
CLI tool
Simple command-line interface that fits into CI/CD pipelines. Read from files or directly from a live cluster.
9 providers
Support for NGINX, Istio, Kong, Apisix, GCE, OpenAPI3, Traefik, and more — each with provider-specific annotation handling.
File or cluster input
Read Ingress resources from local YAML files with --input-file or directly from a connected Kubernetes cluster.
Installation
# Install with Go
go install github.com/kubernetes-sigs/ingress2gateway@v1.1.0# Or install with Homebrew (macOS / Linux)
brew install ingress2gatewayUsage
# Convert from a YAML file
ingress2gateway print \
--providers=nginx \
--input-file=my-ingress.yaml# Convert from a live cluster (current context)
ingress2gateway print \
--providers=nginx# Convert and save to a file
ingress2gateway print \
--providers=nginx \
--input-file=my-ingress.yaml > gateway-resources.yaml