Helm
Zilla Console is deployed using Helm charts published to an OCI registry. These charts support both managed Kubernetes services and self-managed Kubernetes environments.
Use the umbrella chart to install the core platform components together, or deploy individual charts for more granular control.
Helm Chart
Zilla Console is deployed using a single umbrella Helm chart published to an OCI registry.
The umbrella chart installs all core platform components, including the Console, Management plane, and Control plane, into a single Kubernetes namespace.
OCI registry path:
oci://ghcr.io/aklivity/charts/zilla-platform-umbrellaSupported Kubernetes Distributions
Select the guide that matches your Kubernetes environment:
Amazon EKS: For deployments on Amazon Elastic Kubernetes Service.
Self-Managed Kubernetes: For on-premises clusters or local Kubernetes environments.
The charts automatically configure ingress based on the global.kubernetes.distribution value:
| Distribution | Ingress Class | Load Balancer | Notes |
|---|---|---|---|
k8s (default) | nginx | NodePort/ClusterIP | Uses NGINX Ingress Controller |
eks | alb | AWS ALB/NLB | Uses AWS Load Balancer Controller |
aks | azure-application-gateway | Azure App Gateway | Uses Application Gateway Ingress |
Warning
Set this at global.kubernetes.distribution. A top-level --set kubernetes.distribution=… is not read by the umbrella chart: it is silently ignored, and every ingress falls back to the nginx class.
Chart Version
Always pin the chart version with --version. Helm skips pre-release versions when no --version is given, so an unpinned install of a pre-release line silently resolves an older stable chart instead.
export CHART_VERSION="<CHART_VERSION>"