Quick Start

In this guide, we’ll walk you through how to install KubeMQ into your Kubernetes cluster.

Then we’ll send and receive queue messages to verify your KubeMQ installation.

Installing KubeMQ is easy. First, you will install kubemqctl the KubeMQ CLI (command-line interface) onto your local machine. Using this CLI, you’ll then install KubeMQ cluster into your Kubernetes cluster. Finally, you’ll send a hello-world message to a queue and retrieve the message for verification of proper KubeMQ cluster installation.


Get kubemqctl

Kubemqctl is a CLI (Command Line Interface) tool to deploy and manage KubeMQ cluster.

curl -sL https://get.kubemq.io/install | sh
Download the latest kubemqctl from: https://github.com/kubemq-io/kubemqctl/releases/download/latest/kubemqctl.exe
Place the file under e.g. C:Program Fileskubemqctlkubemqctl.exe
Add that directory to your system path to access it from any command prompt


Create a KubeMQ Cluster

Now that you have kubemqctl installed, we will create a KubeMQ cluster:

kubemqctl cluster create -t {{your_kubemq-Token}}


Send ‘hello-world’

After you have created a KubeMQ cluster, you can send hello-world message to q1 queue channel.

kubemqctl queue send q1 hello-world


Get ‘hello-world’

After you have sent a message to q1 queue channel, you can retrieve the message like this:

kubemqctl queue receive q1



You’ve sent your first Event message using KubeMQ!

Next steps:

Check out our SDK reference and code examples .NET, GO, Java, Python and REST.

Read our documentation

Send a Message