ztunnel
Helm chart
Request a free trial
Contact our team to test out this Helm chart and related images for free. Please also indicate any other images you would like to evaluate.
Tag:
1
# "_internal_defaults_do_not_set" is a workaround for Helm limitations. Users should NOT set "._internal_defaults_do_not_set" explicitly, but rather directly set the fields internally.
2
# For instance, instead of `--set _internal_defaults_do_not_set.foo=bar``, just set `--set foo=bar`.
3
image: chainreg.biz/chainguard-private/ztunnel:latest@sha256:f8ec40af509df8dd1ac744f9b426108c368d97f936e35a87de75ccd1c9348599
4
_internal_defaults_do_not_set:
5
# Hub to pull from. Image will be `Hub/Image:Tag-Variant`
6
hub: gcr.io/istio-testing
7
# Tag to pull from. Image will be `Hub/Image:Tag-Variant`
8
tag: latest
9
# Variant to pull. Options are "debug" or "distroless". Unset will use the default for the given version.
10
variant: ""
11
# Image name to pull from. Image will be `Hub/Image:Tag-Variant`
12
# If Image contains a "/", it will replace the entire `image` in the pod.
13
image: ztunnel
14
# Same as `global.network`, but will override it if set.
15
# Network defines the network this cluster belong to. This name
16
# corresponds to the networks in the map of mesh networks.
17
network: ""
18
# resourceName, if set, will override the naming of resources. If not set, will default to 'ztunnel'.
19
# If you set this, you MUST also set `trustedZtunnelName` in the `istiod` chart.
20
resourceName: ""
21
# Labels to apply to all top level resources
22
labels: {}
23
# Annotations to apply to all top level resources
24
annotations: {}
25
# Additional volumeMounts to the ztunnel container
26
volumeMounts: []
27
# Additional volumes to the ztunnel pod
28
volumes: []
29
# Tolerations for the ztunnel pod
30
tolerations:
31
- effect: NoSchedule
32
operator: Exists
33
- key: CriticalAddonsOnly
34
operator: Exists
35
- effect: NoExecute
36
operator: Exists
37
# Annotations added to each pod. The default annotations are required for scraping prometheus (in most environments).
38
podAnnotations:
39
prometheus.io/port: "15020"
40
prometheus.io/scrape: "true"
41
# Additional labels to apply on the pod level
42
podLabels: {}
43
# Pod resource configuration
44
resources:
45
requests:
46
cpu: 200m
47
# Ztunnel memory scales with the size of the cluster and traffic load
48
# While there are many factors, this is enough for ~200k pod cluster or 100k concurrently open connections.
49
memory: 512Mi
50
resourceQuotas:
51
enabled: false
52
pods: 5000
53
# List of secret names to add to the service account as image pull secrets
54
imagePullSecrets: []
55
# A `key: value` mapping of environment variables to add to the pod
56
env: {}
57
# Override for the pod imagePullPolicy
58
imagePullPolicy: ""
59
# Settings for multicluster
60
multiCluster:
61
# The name of the cluster we are installing in. Note this is a user-defined name, which must be consistent
62
# with Istiod configuration.
63
clusterName: ""
64
# meshConfig defines runtime configuration of components.
65
# For ztunnel, only defaultConfig is used, but this is nested under `meshConfig` for consistency with other
66
# components.
67
# TODO: https://github.com/istio/istio/issues/43248
68
meshConfig:
69
defaultConfig:
70
proxyMetadata: {}
71
# This value defines:
72
# 1. how many seconds kube waits for ztunnel pod to gracefully exit before forcibly terminating it (this value)
73
# 2. how many seconds ztunnel waits to drain its own connections (this value - 1 sec)
74
# Default K8S value is 30 seconds
75
terminationGracePeriodSeconds: 30
76
# Revision is set as 'version' label and part of the resource names when installing multiple control planes.
77
# Used to locate the XDS and CA, if caAddress or xdsAddress are not set explicitly.
78
revision: ""
79
# The customized CA address to retrieve certificates for the pods in the cluster.
80
# CSR clients such as the Istio Agent and ingress gateways can use this to specify the CA endpoint.
81
caAddress: ""
82
# The customized XDS address to retrieve configuration.
83
# This should include the port - 15012 for Istiod. TLS will be used with the certificates in "istiod-ca-cert" secret.
84
# By default, it is istiod.istio-system.svc:15012 if revision is not set, or istiod-<revision>.<istioNamespace>.svc:15012
85
xdsAddress: ""
86
# Used to locate the XDS and CA, if caAddress or xdsAddress are not set.
87
istioNamespace: istio-system
88
# Configuration log level of ztunnel binary, default is info.
89
# Valid values are: trace, debug, info, warn, error
90
logLevel: info
91
# To output all logs in json format
92
logAsJson: false
93
# Set to `type: RuntimeDefault` to use the default profile if available.
94
seLinuxOptions: {}
95
# TODO Ambient inpod - for OpenShift, set to the following to get writable sockets in hostmounts to work, eventually consider CSI driver instead
96
#seLinuxOptions:
97
# type: spc_t
98
99
# resourceScope controls what resources will be processed by helm.
100
# This is useful when installing Istio on a cluster where some resources need to be owned by a cluster administrator and some can be owned by the mesh administrator.
101
# It can be one of:
102
# - all: all resources are processed
103
# - cluster: only cluster-scoped resources are processed
104
# - namespace: only namespace-scoped resources are processed
105
resourceScope: all
106
# K8s DaemonSet update strategy.
107
# https://kubernetes.io/docs/reference/kubernetes-api/workload-resources/daemon-set-v1/#DaemonSetSpec).
108
updateStrategy:
109
type: RollingUpdate
110
rollingUpdate:
111
maxSurge: 1
112
maxUnavailable: 0
113
The trusted source for open source
Talk to an expertProduct
Customers
© 2026 Chainguard, Inc. All Rights Reserved.
Chainguard® and the Chainguard logo are registered trademarks of Chainguard, Inc. in the United States and/or other countries.
The other respective trademarks mentioned on this page are owned by the respective companies and use of them does not imply any affiliation or endorsement.
Chainguard® and the Chainguard logo are registered trademarks of Chainguard, Inc. in the United States and/or other countries.
The other respective trademarks mentioned on this page are owned by the respective companies and use of them does not imply any affiliation or endorsement.