Helm

    Finally you can follow the to take it from here and continue your Kuma journey.

    Kuma also provides an alternative Kubernetes distribution that we can use instead of Helm charts.

    To start using Kuma with Helm charts, we first need to add the to our local Helm deployment:

    Once the repo is added, all following updates can be fetched with .

    At this point we can install and run Kuma using the following commands. We could use any Kubernetes namespace to install Kuma, by default we suggest using kuma-system:

      This example will run Kuma in standalone mode for a “flat” deployment, but there are more advanced deployment modes like “multi-zone”.

      Kuma ships with a read-only GUI that you can use to retrieve Kuma resources. By default the GUI listens on the API port and defaults to :5681/gui.

      To access Kuma we need to first port-forward the API service with:

      1. $ kubectl port-forward svc/kuma-control-plane -n kuma-system 5681:5681

      And then navigate to to see the GUI.

      You can use Kuma with kubectl to perform read and write operations on Kuma resources. For example:

      or you can enable mTLS on the default Mesh with:

      2. kind: Mesh
      3. metadata:
      4.   name: default
      5. spec:
      6.   mtls:
      7.     backends:
      8.     - name: ca-1
      9.       type: builtin" | kubectl apply -f -

      Kuma ships with a read-only HTTP API that you can use to retrieve Kuma resources.

      1. $ kubectl port-forward svc/kuma-control-plane -n kuma-system 5681:5681

      And then you can navigate to (opens new window) to see the HTTP API.

      You can use the kumactl CLI to perform read-only operations on Kuma resources. The kumactl binary is a client to the Kuma HTTP API, you will need to first port-forward the API service with:

      and then run kumactl, for example:

      1. $ kumactl get meshes
      2. NAME          mTLS      METRICS      LOGGING   TRACING
      3. default       off       off          off       off

      You can configure kumactl to point to any zone kuma-cp instance by running:

        You will notice that Kuma automatically creates a entity with name default.

        Congratulations! You have successfully installed Kuma on Kubernetes 🚀.