Skip to main content
Version: Next

Install with Helm

Helm is a package manager for Kubernetes that automates the release and management of software on Kubernetes.

This document guides you through installing the APISIX ingress controller using Helm.

Prerequisites#

Before installing APISIX ingress controller, ensure you have:

  1. A working Kubernetes cluster (version 1.26+)
    • Production: TKE, EKS, AKS, or other cloud-managed clusters
    • Development: minikube, kind, or k3s
  2. kubectl installed and configured to access your cluster
  3. Helm (version 3.8+) installed

Install APISIX Ingress Controller#

The APISIX ingress controller can be installed using the Helm chart provided by the Apache APISIX project. The following steps will guide you through the installation process.

helm repo add apisix https://charts.apiseven.com
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

# Set the access address and adminkey for apisix
helm install apisix-ingress-controller \
  --create-namespace \
  -n ingress-apisix \
  --set gatewayProxy.createDefault=true \
  --set gatewayProxy.provider.controlPlane.auth.adminKey.value=edd1c9f034335f136f87ad84b625c8f1 \
  --set apisix.adminService.namespace=apisix-ingress \
  --set apisix.adminService.name=apisix-admin \
  --set apisix.adminService.port=9180 \
  apisix/apisix-ingress-controller