How to fix ingressClass not found in Kubernetes

KubernetesBEGINNERHIGHUpdated Dec 6, 2025· 88 views

Error when Ingress references missing ingressClass

Quick fix

Fixes ingressClass not found

  1. List classes
  2. Check className
  3. Install controller
  4. Update className
  5. Create class
kubernetes — error
# ingressClass not found
ingressClass not found

What this error means

Specified ingressClassName does not exist

Typical symptoms

  • pending ingress
  • no external IP
  • class not found
  • empty classes
  • ignored

Common causes

  1. controller missing
  2. typo
  3. class missing
  4. wrong namespace
  5. not registered

How to fix "ingressClass not found"

1List classes

kubectl get ingressclass

2Check className

kubectl get ingress -o yaml

3Install controller

helm install nginx-ingress

4Update className

kubectl patch ingress

5Create class

kubectl apply -f ingressclass.yaml

6Verify

kubectl get ingress shows IP

Advanced notes

IngressClass is cluster-scoped. Multiple allowed. Controller self-registers.

Frequently asked questions

What does "ingressClass not found" mean?
Specified ingressClassName does not exist
How do I fix "ingressClass not found"?
Error when Ingress references missing ingressClass
What causes "ingressClass not found"?
controller missing typo class missing
Is the "ingressClass not found" error serious?
Yes. This is a high-severity error that usually blocks work until it is fixed, but the steps above resolve it.

Official resources & further reading