Istio Ztunnel
Istio Ztunnel is the node-level proxy for Istio Ambient Mesh that encrypts and directs service-to-service traffic without per-pod sidecars or application code…
Platform availability
Available on 0 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
63/100 Good
- Maintained
- 100last commit 17 days ago
- Popular
- 54490 GitHub stars
- Easy to install
- 250 install platforms, install notes, Docker image
- Light to run
- 85512 MB minimum RAM
- Security check
- 201 serious finding, tests
Security check: 1 serious finding
- A private key is committed in the source code (src/tls/certificate.rs:533)
Automated checks on commit dac5a60, 31 Oct 2026. Not an audit.
- GitHub stars
- 490
- Open issues
- 129
- Last commit
- 2026-11-04
- License
- Apache-2.0
- Activity
- rising
Checked 16 days ago - source: GitHub (istio/ztunnel)
Resources & Compatibility
Minimum requirements: 512 MB RAM. ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set up SPIRE before Istio/ztunnel If your deployment uses SPIRE for node identity, apply the SPIRE quickstart manifest before installing Istio or ztunnel. It creates the SPIRE sockets that Istio expects, so skipping it can break socket injection and mesh authentication. source
- Install the Istio control plane first Deploy istiod (Istio’s discovery/control plane service) in a namespace like istio-system before running ztunnel. ztunnel needs this control plane for mesh configuration and service discovery, so without it the ztunnel pods have nothing to talk to. source
- Set the Istio image hub and tag If your install instructions ask for hub and tag, fill them in for the Istio images you are deploying. Hub is the image registry and tag is the version, so missing or mismatched values can pull the wrong ztunnel or control-plane images. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do I need to install SPIRE before Istio or ztunnel?
If your deployment uses SPIRE for node identity, apply the SPIRE quickstart manifest before installing Istio or ztunnel. It creates the SPIRE sockets that Istio expects, and skipping it can break socket injection and mesh authentication.
What must be deployed before ztunnel pods can operate?
Deploy istiod, Istio’s discovery and control plane service, in a namespace like istio-system first. ztunnel needs this control plane for mesh configuration and service discovery.
What image values should I check if ztunnel or control-plane images fail to pull?
Set the hub and tag for the Istio images, where hub is the image registry and tag is the version. Missing or mismatched values can pull the wrong ztunnel or control-plane images.
What should I inspect when ztunnel has connectivity problems?
Monitor the ztunnel proxy configuration and datapath. This information can help identify high-level problems and collect details for a bug report.
Answers sourced from github.com, github.com, github.com, istio.io
Community
Collected 48 days ago - public community threads