# 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
# Run Kuma
Finally, we can install and run Kuma:
kumactl install control-plane | kubectl apply -f -
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
# 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.
← Enterprise Helm →