# Amazon Linux

If you wish to use Kuma on Amazon EKS please follow the Kubernetes instructions instead.

To install and run Kuma on Amazon Linux (x86_64) execute the following steps:

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

# 1. Download Kuma

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

$ yum install -y tar gzip
$ curl -L https://kuma.io/installer.sh | sh -
1
2

or you can download the distribution manually.

Then extract the archive with:

$ tar xvzf kuma-0.5.0*.tar.gz
1

# 2. Run Kuma

Once downloaded, you will find the contents of Kuma in the kuma-0.5.0 folder. In this folder, you will find - among other files - the bin directory that stores all the executables for Kuma.

So we enter the bin folder by executing:

$ cd kuma-0.5.0/bin
1

And we can then proceed to run Kuma with:

$ ./kuma-cp run
1

We suggest adding the kumactl executable to your 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 ./kumactl /usr/local/bin/kumactl
1

Note: By default this will run Kuma with a memory backend, but you can use a persistent storage like PostgreSQL by updating the conf/kuma-cp.conf file.

# 3. Use Kuma

Kuma (kuma-cp) is now running! Now that Kuma has been installed you can access the control-plane via either the GUI, the HTTP API, or the CLI:

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

    # 4. Quickstart

    Congratulations! You have successfully installed Kuma on Amazon Linux 🚀.

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