Install kumactl

This how-to guide explains how to install kumactl in your environment.

kumactl is a CLI tool that you can use to access Kuma. It can do the following:

  • Perform read-only operations on Kuma resources on Kubernetes.
  • Read and create resources in Kuma in Universal mode.

The kumactl binary is a client to the Kuma HTTP API.

Download Kuma:

Make sure you have tar and gzip installed.

Run the following script to automatically detect the operating system and download Kuma:

  1. curl -L https://kuma.io/installer.sh | VERSION=2.3.1 sh -

You can omit the VERSION variable to install the latest version.

Download the distribution manually. Download a distribution for the client host from where you will be executing kumactl:

The latest version is: 2.3.1.

You can find all released versions for all targets from: The download page.

On macOS you can use brew install kumactl.

and extract the archive with tar -xvzf kuma-2.3.1.tar.gz

Add the kumactl executable to your path:

  1. cd kuma-2.3.1/bin
  2. PATH=$(pwd):$PATH

Next steps

After you’ve installed kumactl, you can deploy Kuma in standalone or multi-zone mode in either Kubernetes or Universal.