Ingress Configuration

Kubernetes Dashboard can be exposed externally using Kubernetes Ingress resources. The Helm chart supports automatic Ingress creation with TLS certificate management via cert-manager.

Enable Ingress

app.ingress.enabled

boolean

default:"false"

Enable Ingress resource creation.

app:
  ingress:
    enabled: true

Hosts Configuration

app.ingress.hosts

array

default:"[\"localhost\"]"

List of hostnames for the Ingress resource.

app:
  ingress:
    enabled: true
    hosts:
      - dashboard.example.com
      - k8s-dashboard.company.internal

Default includes localhost for use with kubectl port-forward:

kubectl port-forward -n kubernetes-dashboard service/kubernetes-dashboard-kong-proxy 8443:443
# Access at https://localhost:8443

Remove localhost when exposing Dashboard externally.

Ingress Class

app.ingress.ingressClassName

string

default:"internal-nginx"

IngressClass to use for the Ingress resource.

app:
  ingress:
    enabled: true
    ingressClassName: nginx

Common values:

nginx - For nginx-ingress-controller
traefik - For Traefik
alb - For AWS ALB Ingress Controller
gce - For GCE Ingress Controller

app.ingress.useDefaultIngressClass

boolean

default:"false"

Use the cluster’s default IngressClass instead of specifying one.

app:
  ingress:
    enabled: true
    useDefaultIngressClass: true

When true, the ingressClassName field is omitted, and the cluster’s default IngressClass is used.

Path Configuration

app.ingress.path

string

default:"/"

URL path for accessing Dashboard.

app:
  ingress:
    enabled: true
    path: /

Serving on a sub-path:

app:
  ingress:
    enabled: true
    path: /dashboard

When path is not /, a nginx.ingress.kubernetes.io/rewrite-target: /$2 annotation is automatically added for proper routing.

Ensure the configured path doesn’t conflict with Kong gateway route configuration.

app.ingress.pathType

string

default:"ImplementationSpecific"

Ingress path type.

app:
  ingress:
    enabled: true
    pathType: Prefix

Options:

Prefix - Matches based on URL path prefix
Exact - Exact path matching
ImplementationSpecific - Interpretation depends on IngressClass

See Kubernetes Ingress documentation.

TLS Configuration

app.ingress.tls.enabled

boolean

default:"true"

Enable TLS for Ingress.

app:
  ingress:
    enabled: true
    tls:
      enabled: true

TLS is highly recommended for production deployments to secure dashboard access.

app.ingress.tls.secretName

string

default:""

Name of the TLS Secret containing certificate and key.

app:
  ingress:
    enabled: true
    tls:
      enabled: true
      secretName: dashboard-tls-cert

If empty (default), the secret name is auto-generated as kubernetes-dashboard-certs.The Secret must contain:

tls.crt - TLS certificate
tls.key - TLS private key

Cert-Manager Integration

The chart integrates with cert-manager for automatic certificate management.

app.ingress.issuer.name

string

default:"selfsigned"

Name of the cert-manager Issuer or ClusterIssuer.

app:
  ingress:
    enabled: true
    issuer:
      name: letsencrypt-prod
      scope: cluster
    tls:
      enabled: true

app.ingress.issuer.scope

string

default:"default"

Scope of the cert-manager issuer.

app:
  ingress:
    issuer:
      name: letsencrypt-prod
      scope: cluster

Options:

default - Adds cert-manager.io/issuer annotation (namespace-scoped Issuer)
cluster - Adds cert-manager.io/cluster-issuer annotation (cluster-scoped ClusterIssuer)
disabled - Disables cert-manager annotations

Resulting annotations:

For default: cert-manager.io/issuer: <issuer.name>
For cluster: cert-manager.io/cluster-issuer: <issuer.name>

Example: Let’s Encrypt with cert-manager

app:
  ingress:
    enabled: true
    hosts:
      - dashboard.example.com
    ingressClassName: nginx
    issuer:
      name: letsencrypt-prod
      scope: cluster
    tls:
      enabled: true
      secretName: ""  # Auto-generated

Prerequisites:

cert-manager installed in cluster
ClusterIssuer created:

apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-prod
spec:
  acme:
    server: https://acme-v02.api.letsencrypt.org/directory
    email: [email protected]
    privateKeySecretRef:
      name: letsencrypt-prod
    solvers:
      - http01:
          ingress:
            class: nginx

Annotations

app.ingress.useDefaultAnnotations

boolean

default:"true"

Append default nginx annotations required for Dashboard.

app:
  ingress:
    enabled: true
    useDefaultAnnotations: true

When true, adds:

nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
nginx.ingress.kubernetes.io/ssl-passthrough: "true"
nginx.ingress.kubernetes.io/ssl-redirect: "true"

These are required for proper HTTPS passthrough to Kong gateway.

app.ingress.annotations

object

default:"{}"

Additional custom annotations for the Ingress resource.

app:
  ingress:
    enabled: true
    annotations:
      nginx.ingress.kubernetes.io/force-ssl-redirect: "true"
      nginx.ingress.kubernetes.io/proxy-body-size: "100m"
      nginx.ingress.kubernetes.io/proxy-read-timeout: "600"
      nginx.ingress.kubernetes.io/proxy-send-timeout: "600"

app.ingress.labels

object

default:"{}"

Additional labels for the Ingress resource.

app:
  ingress:
    enabled: true
    labels:
      environment: production
      team: platform

Example Configurations

Basic Public Ingress with nginx

app:
  ingress:
    enabled: true
    hosts:
      - dashboard.k8s.example.com
    ingressClassName: nginx
    issuer:
      name: letsencrypt-prod
      scope: cluster
    tls:
      enabled: true

Internal Ingress with Self-Signed Certificate

app:
  ingress:
    enabled: true
    hosts:
      - dashboard.internal.local
    ingressClassName: internal-nginx
    issuer:
      name: selfsigned
      scope: default
    tls:
      enabled: true
      secretName: dashboard-selfsigned-cert

nginx:
  enabled: true  # Enable bundled nginx ingress
  controller:
    ingressClassResource:
      name: internal-nginx
      default: false
    service:
      type: ClusterIP

cert-manager:
  enabled: true  # Enable bundled cert-manager
  installCRDs: true

Create self-signed issuer:

apiVersion: cert-manager.io/v1
kind: Issuer
metadata:
  name: selfsigned
  namespace: kubernetes-dashboard
spec:
  selfSigned: {}

AWS ALB Ingress

app:
  ingress:
    enabled: true
    hosts:
      - dashboard.example.com
    ingressClassName: alb
    useDefaultAnnotations: false  # ALB doesn't need nginx annotations
    annotations:
      alb.ingress.kubernetes.io/scheme: internet-facing
      alb.ingress.kubernetes.io/target-type: ip
      alb.ingress.kubernetes.io/listen-ports: '[{"HTTPS":443}]'
      alb.ingress.kubernetes.io/certificate-arn: arn:aws:acm:us-east-1:123456789:certificate/xyz
      alb.ingress.kubernetes.io/ssl-redirect: '443'
    issuer:
      scope: disabled  # Using ACM certificate
    tls:
      enabled: true

Traefik Ingress

app:
  ingress:
    enabled: true
    hosts:
      - dashboard.example.com
    ingressClassName: traefik
    useDefaultAnnotations: false
    annotations:
      traefik.ingress.kubernetes.io/router.entrypoints: websecure
      traefik.ingress.kubernetes.io/router.tls: "true"
      cert-manager.io/cluster-issuer: letsencrypt-prod
    issuer:
      name: letsencrypt-prod
      scope: cluster
    tls:
      enabled: true

Sub-Path Deployment

app:
  ingress:
    enabled: true
    hosts:
      - apps.example.com
    path: /dashboard
    pathType: Prefix
    ingressClassName: nginx
    useDefaultAnnotations: true  # Adds rewrite-target automatically
    issuer:
      name: letsencrypt-prod
      scope: cluster
    tls:
      enabled: true

Access at: https://apps.example.com/dashboard

Multiple Hosts

app:
  ingress:
    enabled: true
    hosts:
      - dashboard.example.com
      - k8s.example.com
      - dashboard.internal.local
    ingressClassName: nginx
    issuer:
      name: letsencrypt-prod
      scope: cluster
    tls:
      enabled: true

All hosts will share the same TLS certificate (SAN certificate).

Accessing Dashboard Through Ingress

Once Ingress is configured and certificates are issued:

Verify Ingress is created:

kubectl get ingress -n kubernetes-dashboard

Check certificate status:

kubectl get certificate -n kubernetes-dashboard
kubectl describe certificate kubernetes-dashboard-certs -n kubernetes-dashboard

Access Dashboard:
```
https://dashboard.example.com
```
Verify TLS:
```
curl -v https://dashboard.example.com
```

Troubleshooting

Certificate Not Issued

# Check certificate status
kubectl describe certificate -n kubernetes-dashboard

# Check cert-manager logs
kubectl logs -n cert-manager deployment/cert-manager

# Check certificate request
kubectl get certificaterequest -n kubernetes-dashboard
kubectl describe certificaterequest -n kubernetes-dashboard

502 Bad Gateway

Verify Kong proxy is running:

kubectl get pods -n kubernetes-dashboard -l app.kubernetes.io/name=kong

Check if useDefaultAnnotations is enabled for nginx ingress

Verify backend protocol annotation:

kubectl get ingress -n kubernetes-dashboard -o yaml | grep backend-protocol

SSL Passthrough Issues

If using nginx ingress with SSL passthrough:

Ensure nginx ingress controller has --enable-ssl-passthrough flag
Verify ssl-passthrough: "true" annotation is present
Check Kong is listening on HTTPS (default: 8443)

Path-Based Routing Not Working

Verify rewrite-target annotation when using sub-paths
Check Kong gateway route configuration
Ensure pathType is set correctly (usually Prefix)

Security Considerations

Always use TLS in production
Use valid certificates from trusted CAs (e.g., Let’s Encrypt)
Restrict access using Network Policies or Ingress rules
Enable authentication - Dashboard doesn’t provide built-in auth; users authenticate with Kubernetes tokens
Use internal Ingress for sensitive environments
Set resource limits on Ingress controller

Security Configuration - Network policies and TLS
Helm Values Reference - Complete configuration reference
Settings - Dashboard UI settings

Get Started

User Guide

Architecture

Configuration

Enable Ingress

Hosts Configuration

Ingress Class

Path Configuration

TLS Configuration

Cert-Manager Integration

Example: Let’s Encrypt with cert-manager

Annotations

Example Configurations

Basic Public Ingress with nginx

Internal Ingress with Self-Signed Certificate

AWS ALB Ingress

Traefik Ingress

Sub-Path Deployment

Multiple Hosts

Accessing Dashboard Through Ingress

Troubleshooting

Certificate Not Issued

502 Bad Gateway

SSL Passthrough Issues

Path-Based Routing Not Working

Security Considerations

Build docs developers (and LLMs) love

Get Started

User Guide

Architecture

Configuration

​Enable Ingress

​Hosts Configuration

​Ingress Class

​Path Configuration

​TLS Configuration

​Cert-Manager Integration

​Example: Let’s Encrypt with cert-manager

​Annotations

​Example Configurations

​Basic Public Ingress with nginx

​Internal Ingress with Self-Signed Certificate

​AWS ALB Ingress

​Traefik Ingress

​Sub-Path Deployment

​Multiple Hosts

​Accessing Dashboard Through Ingress

​Troubleshooting

​Certificate Not Issued

​502 Bad Gateway

​SSL Passthrough Issues

​Path-Based Routing Not Working

​Security Considerations

​Related Configuration

Build docs developers (and LLMs) love

Enable Ingress

Hosts Configuration

Ingress Class

Path Configuration

TLS Configuration

Cert-Manager Integration

Example: Let’s Encrypt with cert-manager

Annotations

Example Configurations

Basic Public Ingress with nginx

Internal Ingress with Self-Signed Certificate

AWS ALB Ingress

Traefik Ingress

Sub-Path Deployment

Multiple Hosts

Accessing Dashboard Through Ingress

Troubleshooting

Certificate Not Issued

502 Bad Gateway

SSL Passthrough Issues

Path-Based Routing Not Working

Security Considerations

Related Configuration