---
id: "kuma"
type: "component"
kind: "service-mesh"
provider: "default"
category: "ops"
docs: "https://kuma.io/docs/latest/policies/mutual-tls/"
url: "https://localhost:3000/catalogue/components/kuma"
---

# Kuma

Envoy-based service mesh with a multi-zone control plane; mTLS is opt-in per mesh.

| | |
|---|---|
| Provider | [default](https://localhost:3000/catalogue?provider=default) |
| Kind | [Service mesh](https://localhost:3000/catalogue/kinds/service-mesh) |
| Category | Operations |
| Official docs | [https://kuma.io/docs/latest/policies/mutual-tls/](https://kuma.io/docs/latest/policies/mutual-tls/) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `circuitBreaking` | boolean | — | no | false | **false** |
| `controlPlanes` | integer | — | no | — | inherited |
| `environment` | enum | `kubernetes`, `universal` | no | "kubernetes" | inherited |
| `managed` | boolean | — | no | false | **false** |
| `mtls` | boolean | — | no | false | **false** |
| `multiZone` | boolean | — | no | false | inherited |
| `retries` | boolean | — | no | false | **false** |
| `sidecar` | boolean | — | no | true | **true** |
| `trafficPermissionRequired` | boolean | — | no | false | inherited |

Bold values are the ones this component pins.

## Rules that apply · 0

No rule selects this kind or its category.

## Other products of the same kind · 11

- [AWS App Mesh](https://localhost:3000/catalogue/components/aws-app-mesh.md) `aws-app-mesh` — aws
- [Amazon VPC Lattice](https://localhost:3000/catalogue/components/aws-vpc-lattice.md) `aws-vpc-lattice` — aws
- [Cilium](https://localhost:3000/catalogue/components/cilium.md) `cilium` — default
- [Consul Connect](https://localhost:3000/catalogue/components/consul-connect.md) `consul-connect` — default
- [Dapr](https://localhost:3000/catalogue/components/dapr.md) `dapr` — default
- [Envoy sidecar](https://localhost:3000/catalogue/components/envoy-sidecar.md) `envoy-sidecar` — default
- [Istio](https://localhost:3000/catalogue/components/istio.md) `istio` — default
- [Kmesh](https://localhost:3000/catalogue/components/kmesh.md) `kmesh` — default
- [Linkerd](https://localhost:3000/catalogue/components/linkerd.md) `linkerd` — default
- [Generic service mesh](https://localhost:3000/catalogue/components/service-mesh.md) `service-mesh` — default
- [Cloud Service Mesh](https://localhost:3000/catalogue/components/google-cloud-service-mesh.md) `google-cloud-service-mesh` — gcp

## Use it in a design

```yaml
nodes:
  - { id: "kuma", component: "kuma" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# Kuma: Envoy sidecar mesh with a universal/Kubernetes control plane. The "Mutual TLS" policy
# page states mTLS is not enabled by default and must be turned on per mesh.
schemaVersion: "1"
type: "component"
id: "kuma"
kind: "service-mesh"
provider: "default"
docs: "https://kuma.io/docs/latest/policies/mutual-tls/"
defaults:
  managed: false
  sidecar: true
  mtls: false
  retries: false
  circuitBreaking: false
properties:
  environment:
    type: "enum"
    values: ["kubernetes", "universal"]
    default: "kubernetes"
  multiZone:
    type: "boolean"
    default: false
  trafficPermissionRequired:
    type: "boolean"
    default: false
```

Human page: https://localhost:3000/catalogue/components/kuma