# Kubernetes

To install and run Kuma execute the following steps:

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

Kuma also provides Helm charts that we can use instead of this distribution.

# Download Kumactl

To run Kuma on Kubernetes, you need to download the Kuma cli (kumactl) on your machine.

    Once downloaded, you will find the contents of Kuma in the kuma-1.6.0 folder. In this folder, you will find - among other files - the bin directory that stores the executables for Kuma, including the CLI client kumactl.

    Note: On Kubernetes - of all the Kuma binaries in the bin folder - we only need kumactl.

    So we enter the bin folder by executing: cd kuma-1.6.0/bin

    We suggest adding the kumactl executable to your PATH (by executing: PATH=$(pwd):$PATH) so that it's always available in every working directory. Or - alternatively - you can also create link in /usr/local/bin/ by executing:

    ln -s $PWD/kumactl /usr/local/bin/kumactl
    
    1

    # Run Kuma

    Finally, we can install and run Kuma:

    kumactl install control-plane | kubectl apply -f -
    
    1

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

    It may take a while for Kubernetes to start the Kuma resources, you can check the status by executing:

    kubectl get pod -n kuma-system
    
    1

    # Use Kuma

    Kuma (kuma-cp) will be installed in the newly created kuma-system namespace! Now that Kuma has been installed, you can access the control-plane via either the GUI, kubectl, the HTTP API, or the CLI:

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

      # Quickstart

      Congratulations! You have successfully installed Kuma on Kubernetes 🚀.

      In order to start using Kuma, it's time to check out the quickstart guide for Kubernetes deployments.

      Last Updated: 5/13/2022, 3:47:11 PM