You are browsing documentation for a version of Kuma that is not the latest release.

Looking for even older versions? Learn more.

Single-zone deployment


This is the simplest deployment mode for Kuma, and the default one.

  • Zone control plane: There is one deployment of the control plane that can be scaled horizontally.
  • Data plane proxies: The data plane proxies connect to the control plane regardless of where they are deployed.
  • Service Connectivity: Every data plane proxy must be able to connect to every other data plane proxy regardless of where they are being deployed.

This mode implies that we can deploy Kuma and its data plane proxies so that the service connectivity from every data plane proxy can be established directly to every other data plane proxy.

Single-zone mode is a great choice to start within the context of one zone (ie: within one Kubernetes cluster or one AWS VPC). You can then federate it into a multi-zone deployment.

To Install with this topology follow the single-zone deployment docs.


  • All data plane proxies need to be able to communicate with every other dataplane proxy.
  • A single-zone deployment cannot mix Universal and Kubernetes workloads.
  • A deployment can connect to only one Kubernetes cluster at once.

If these limitations are problematic you should look at Multi-zone deployments.

Components of a single-zone deployment

A single-zone deployment includes:

  • The zone control plane:
    • Accept connections from data plane proxies.
    • Accept creation and changes to policies that will be applied to the data plane proxies.
    • Keep an inventory of all data plane proxies running.
    • Compute and send configurations using XDS to the data plane proxies.
  • The data plane proxies:
    • Connect to the zone control plane.
    • Receive configurations using XDS from the control plane.
    • Connect to other data plane proxies.

Failure modes

Zone control plane offline

  • New data plane proxies won’t be able to join the mesh. This includes new instances (Pod/VM) that are newly created by automatic deployment mechanisms (for example, a rolling update process), meaning a control plane connection failure could block updates of applications and events that create new instances.
  • On mTLS enabled meshes, a data plane proxy may fail to refresh its client certificate prior to expiry (defaults to 24 hours), thus causing traffic from/to this data plane to fail.
  • Data-plane proxy configuration will not be updated.
  • Communication between data planes proxies will still work.

You can think of this failure case as “Freezing” the zone mesh configuration. Communication will still work but changes will not be reflected on existing data plane proxies.