Install the HTTP Add-on

HTTP Add-on installation, upgrade, and removal via Helm

Warning

You are currently viewing v0.15 of the documentation and it is not the latest. For the most recent documentation, kindly click here.

Prerequisites

Before installing the HTTP Add-on, ensure you have:

  • A Kubernetes cluster (tested against the three most recent minor versions)
  • Helm 3
  • KEDA core installed (deployment guide)

If you have not installed KEDA yet, run:

helm repo add kedacore https://kedacore.github.io/charts
helm repo update
helm install keda kedacore/keda --namespace keda --create-namespace

Install

  1. Add the KEDA Helm repository (if you have not already):

    helm repo add kedacore https://kedacore.github.io/charts
    helm repo update
    
  2. Install the HTTP Add-on into the same namespace as KEDA:

    helm install http-add-on kedacore/keda-add-ons-http --namespace keda
    
  3. Verify the installation:

    kubectl get pods -n keda
    

    You should see pods for the operator, interceptor, and scaler components in a Running state.

Helm Values to Consider

The following values are commonly configured at install time. Pass them with --set or in a values file (-f values.yaml).

ValueDescriptionDefault
interceptor.replicas.minMinimum number of interceptor replicas3
interceptor.replicas.maxMaximum number of interceptor replicas50
operator.watchNamespaceRestrict the operator to a single namespace (empty string watches all namespaces)""

For the full list of configuration options, see the http-add-on chart.

Upgrade

To upgrade to a newer version of the HTTP Add-on:

helm repo update
helm upgrade http-add-on kedacore/keda-add-ons-http --namespace keda

The CRDs are included as Helm templates (not in the crds/ directory), so they are updated automatically during helm upgrade.

Uninstall

  1. Remove the HTTP Add-on Helm release:

    helm uninstall http-add-on --namespace keda
    
  2. CRDs are not automatically removed on uninstall. To remove them manually:

    kubectl delete crd httpscaledobjects.http.keda.sh interceptorroutes.http.keda.sh
    

    Warning: Deleting the CRDs removes all HTTPScaledObject and InterceptorRoute resources in the cluster. Make sure you no longer need them before proceeding.

Namespace-Scoped Installation

By default, the operator watches all namespaces for HTTPScaledObject and InterceptorRoute resources. To restrict the operator to a single namespace:

helm install http-add-on kedacore/keda-add-ons-http \
  --namespace keda \
  --set operator.watchNamespace=<your-namespace>

For the full list of configuration options, see the http-add-on chart.

What’s Next