Install Kong Gateway Operator (KGO)

How do I install Kong Gateway Operator?

helm upgrade --install kong-operator kong/kong-operator -n kong-system --create-namespace \
  --set env.ENABLE_CONTROLLER_KONNECT=true

Optional: manage webhook certificates with cert-manager

If you want cert-manager to issue and rotate the admission and conversion webhook certificates, install cert-manager to your cluster and enable cert-manager integration when installing the chart:

helm upgrade --install kong-operator kong/kong-operator -n kong-system --create-namespace \
  --set env.ENABLE_CONTROLLER_KONNECT=true \
  --set global.webhooks.options.certManager.enabled=true

If you do not enable this, the chart will generate and inject self-signed certificates automatically. This is fine for development; for production we recommend enabling cert-manager.

Helm is the only officially supported installation method.

Create a values.yaml file and set a enable_controller_* value under env e.g. env.enable_controller_dataplane_bluegreen: false

Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!