Skip to main content

Deploy Airy with Helm

Deploy Airy with Helm, on an existing Kubernetes cluster.

The goal of this document is to provide an overview of how to run Airy Core in an already existing Kubernetes cluster Helm.


You would need an existing Kubernetes cluster and administrative access to it. For the purpose of this guide, we will use a Google (GKE) Kubernetes cluster.

gcloud container clusters create awesomechat --num-nodes=2

You will also need the Helm and Kubectl binaries, locally on your machine.

Make sure that you can access the cluster running:

$ kubectl get pods
No resources found in default namespace.
$ helm list

Deploy Airy Core#

Deploy Airy Core with the latest version. You can also configure a specific version

VERSION=$(curl -L -s
helm install airy${VERSION}.tgz --timeout 10m

By default Airy Core creates only a HTTP listener and when running in cloud environment it is recommended to setup an encrypted connection.

Get the address of your LoadBalancer:

kubectl -n kube-system get service ingress-nginx-controller -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

Configure your DNS so that your desired hostname points to the IP address of LoadBalancer. In this example we will be using the hostname

Create an airy.yaml file with the following configuration:

https: true
letsencryptEmail: ""
loadbalancerAnnotations: nlb

Run the following command to upgrade your Airy Core installation and setup Let's Encrypt:

$ helm upgrade airy${VERSION}.tgz --values ./airy.yaml

After that you should be able to access your Airy Core instance through HTTPS, in this example on


Deploying Airy Core with Helm gives flexibility to customize your installation.


If you wish to deploy Airy Core to a separate namespace, you need to specify the --namespace flag to Helm.

VERSION=$(curl -L -s
helm install airy${VERSION}.tgz --timeout 10m --namespace airy


The default installation creates its own Kafka cluster. This section explains how to deploy Airy Core on an existing Kafka cluster:

The default settings in the Airy Core platform, on how to access the Kafka resources, can be overwritten in your airy.yaml file:

# Default settings
brokers: "kafka-headless:9092"
zookeepers: "zookeeper:2181"
schemaRegistryUrl: "http://schema-registry:8081"
commitInterval: 1000

Run the following command to create the Airy platform without the bundled installation of Kafka, Zookeeper and the Schema registry.

helm install airy${VERSION}.tgz --set prerequisites.kafka.enabled=false --values ./airy.yaml


The default installation creates its own Beanstalkd deployment, as it is a prerequisite for using the integration/webhook component.

Run the following command to create the Airy platform without the bundled Beanstalkd installation.

helm install airy${VERSION}.tgz --set prerequisites.beanstalkd.enabled=false --values ./airy.yaml

If you wish to omit both Beanstalkd and Kafka, you can use the following command:

helm install airy${VERSION}.tgz --set prerequisites.enabled=false --values ./airy.yaml

Ingress controller#

The default installation creates its own NGinx Kubernetes ingress controller, in the kube-system namespace. If you prefer to use your own Kubernetes ingress controller, run the following command to create Airy without the bundled one:

helm install airy${VERSION}.tgz --set ingress-controller.enabled=false --values ./airy.yaml

The Airy platform comes with defined ingress resources. Feel free to customize them in accordance with your ingress controller. For example to set a custom host parameter, run the following commands:

for ingress in $(kubectl get ingress -l -o jsonpath='{.items[*]}'); do
kubectl get ingress ${ingress} -o json | jq "(.spec.rules[0].host=\"${HOST}\")" | kubectl apply -f -


The resources for the Airy Helm chart are located under infrastructure/helm-chart. You can customize the charts and package or deploy the charts directly to your Kubernetes cluster.

As a reference you can use the script that we use to package and publish the Helm charts, which is located under scripts/

Container registry#

If you wish to build the docker images yourself and store them in your own Container registry, you can overwrite the path of the container registry with the following command:

VERSION=$(curl -L -s
helm install airy${VERSION}.tgz --timeout 10m --set global.containerRegistry=my-docker-registry


To view your existing Helm installation run helm list.

You can see the current revision number of your Helm deployment by running:

helm list --filter 'airy' -o json | jq .[].revision

If you wish to rollback to a previous installation, run:

helm rollback airy {VERSION_NUMBER}

where VERSION_NUMBER is a previous revision number of the airy helm chart.


If you need further help, refer to our Troubleshooting section.

Last updated on