Docker

    The official Docker images are used by default in the Kubernetes and distributions.

    Kuma provides the following Docker images for all of its executables:

    • kuma-cp: at
    • kuma-dp: at kong-docker-kuma-docker.bintray.io/kuma-dp:0.6.0
    • kuma-prometheus-sd: at kong-docker-kuma-docker.bintray.io/kuma-prometheus-sd:0.6.0

    You can freely docker pull these images to start using Kuma, as we will demonstrate in the following steps.

    We can proceed to run Kuma with:

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

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

    Kuma ships with a read-only GUI that you can use to retrieve Kuma resources. By default the GUI listens on port 5683.

    To access Kuma you can navigate to 127.0.0.1:5683 to see the GUI.

    Kuma ships with a read and write HTTP API that you can use to perform operations on Kuma resources. By default the HTTP API listens on port 5681.

    To access Kuma you can navigate to to see the HTTP API.

    You can use the kumactl CLI to perform read and write operations on Kuma resources. The binary is a client to the Kuma HTTP API. For example:

    or you can enable mTLS on the default Mesh with:

    You can run the following script to automatically detect the operating system and download Kuma:

    or you can download the distribution manually:

    and extract the archive with:

    You will then find the kumactl executable in the kuma-0.6.0/bin folder.

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

    Congratulations! You have successfully installed Kuma on Docker 🚀.