# 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 changes. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5543/istio-ztunnel

## Description

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 changes.

## Platform availability

Available on 0 of 10 platforms.

## Health score

63/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 54 (490 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 85 (512 MB minimum RAM)
- Security check: 20 (1 serious finding, tests)

## Security check

1 serious finding: A private key is committed in the source code.
Automated checks on commit dac5a60, 31 Oct 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/ubuntu/istio-ztunnel
- GitHub: https://github.com/istio/ztunnel

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/5543/istio-ztunnel), the self-hosted and open-source app directory.
