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.27 - 1.35 |
| NGINX | 1.29.5 |
Quick Start
# Install via Helm (OCI registry)
helm install nginx-ingress \
oci://ghcr.io/nginx/charts/nginx-ingress \
--version 2.4.4 \
--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.4.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.25+ |
| NGINX | 1.29.5 |
Quick Start
# Install via Helm (OCI registry)
helm install nginx-gateway-fabric \
oci://ghcr.io/nginx/charts/nginx-gateway-fabric \
--version 2.4.2 \
--namespace nginx-gateway-fabric --create-namespaceNGINX Ingress Migration Tool (Coming Soon)
Migrate from the community Ingress-NGINX controller to the Official 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 Official 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 and Official controllers.
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 comprehensive, self-contained HTML application with no external dependencies. It covers every annotation and ConfigMap key from the community controller.
ingress2gateway
Convert Ingress resources to Gateway API resources using the official 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.
8 Providers
Support for NGINX, Istio, Kong, Apisix, GCE, OpenAPI3, 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@v0.5.0
# Or install with Homebrew (macOS / Linux)
brew install ingress2gateway
Usage
# 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