Implementation:Apache Airflow Helm Chart Values

Knowledge Sources	Apache Airflow Airflow Helm Chart
Domains	Kubernetes, Configuration
Last Updated	2026-02-08 00:00 GMT

Overview

Concrete tool for configuring Kubernetes-based Airflow deployments provided by the Helm chart values.yaml and values.schema.json.

Description

The values.yaml (3,557 lines) defines all configurable parameters for the Airflow Helm chart. The values.schema.json (13,840 lines, JSON Schema draft-07) validates the configuration. The Chart.yaml defines chart metadata including the PostgreSQL subchart dependency.

Usage

Create a custom values file and pass it to helm install/upgrade. Use the schema for documentation and IDE auto-completion.

Code Reference

Source Location

• Repository: Apache Airflow
• File: chart/values.yaml (3,557 lines)
• File: chart/values.schema.json (13,840 lines)
• File: chart/Chart.yaml (449 lines)

Signature

# Key top-level configuration sections
defaultAirflowRepository: apache/airflow
defaultAirflowTag: "3.1.7"
airflowVersion: "3.1.7"
executor: CeleryExecutor  # Options: Celery, Local, Kubernetes, CeleryKubernetes
uid: 50000

# Component sections:
# scheduler, webserver, workers, triggerer, dagProcessor, flower
# redis, postgresql, pgbouncer
# dags, logs, config, ports, ingress, networkPolicies, rbac

Import

# Add the Airflow Helm repository
helm repo add apache-airflow https://airflow.apache.org

# Install with default values
helm install airflow apache-airflow/airflow

# Install with custom values
helm install airflow apache-airflow/airflow -f my-values.yaml

I/O Contract

Inputs

Name	Type	Required	Description
values.yaml	YAML	Yes	Default chart configuration
User values override	YAML	No	Custom values file (-f flag)
Kubernetes cluster	Cluster	Yes	Target cluster context

Outputs

Name	Type	Description
Kubernetes manifests	YAML	Rendered Deployments, Services, ConfigMaps, etc.
Helm release	Release	Installed/upgraded Helm release

Usage Examples

Deploy with Custom Values

# my-values.yaml
executor: KubernetesExecutor
scheduler:
  replicas: 2
webserver:
  replicas: 2
dags:
  gitSync:
    enabled: true
    repo: https://github.com/my-org/dags.git
    branch: main

helm install airflow apache-airflow/airflow \
  --namespace airflow \
  --create-namespace \
  -f my-values.yaml

Related Pages

Implements Principle

• Principle:Apache_Airflow_Helm_Values_Configuration

Requires Environment

• Environment:Apache_Airflow_Kubernetes_Helm_Environment